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PREFACE 



How to Use This Manual 

This manual describes the assembly language for the 8086/8088 and the 8087. You 
should already be familiar with the 8086/8087/8088 before attempting to use this 
manual. Because this is a reference manual, it should not be read from cover-to- 
cover. The ASM86 LANGUAGE REFERENCE MANUAL is part of a family of 
manuals designed to help you program the 8086/8088 and the 8087. For you to learn 
how to program the 8086/8087/8088 in assembly language, you should read the 
following manuals: 

The 8086 Family User's Guide, 9800722 

This is an introduction to all the chips in the 8086 family. It describes the hard- 
ware architecture and the instruction set of the 8086/8088. This is essential 
reading! 

The 8086 Family User 's Guide— Numerics Supplement, 121586 

This manual describes the 8087 Numeric Processor. If you are going to be 
programming for the 8087, you should read this manual. 

An Introduction to ASM86, 121689 

This manual serves as an introduction to programming in assembly language for 
the 8086/8088. It will teach you the basic concepts necessary to begin writing 
programs for the 8086/8088. This manual is an introduction to much of the 
material covered in the ASM86 LANGUAGE REFERENCE MANUAL. 

Before plunging into this manual you should read Chapter 1. It introduces some of 
the concepts, terminology, and conventions that are used throughout the manual. 
Sections labeled "Overview" are introductions to material covered in a chapter. 
These sections are intended to give you an overall perspective of the material. In 
Chapter 3, there are two sections entitled "Introduction to...". These sections 
introduce two data structures unique to the assembly language. You should read 
these sections early in your use of the manual. The following is a brief description of 
the chapter contents: 

Chapter 1 — discusses the important issues of the machine architecture (registers, 
segmentation) and introduces the assembly language. 

Chapter 2 — discusses the assembler directives that control segmentation (defining 
program segments). 

Chapter 3 — discusses the definition of variables and labels and the definition and 
initialization of data storage. It also describes the many data structures 
supplied by the assembly language. 

Chapter 4 — describes the possible operand types that you can use with machine 
instructions. It also describes the assembly-time expressions that you 
can use. 

Chapter 5 — describes the directives that allow you to develop modular programs, 
both in assembly language and assembly language programs that will 
link to modules written in other 8086/8088 languages. 



Chapter 6 — fully describes the instruction sets for the 8086/8088 and the 8087. 
Chapter 7 — describes the macro language supplied by the assembler. 



NOTE 

This manual replaces three previous reference manuals for ASM86. There 
are three different assemblers for ASM86. They are: 

a. 8080/8085 based assembler with no 8087 support 

b. 8080/8085 based assembler with 8087 support 

c. 8086 based assembler with 8087 support. 

This manual covers all the versions of the ASM86 assembler. Any dif- 
ferences will be noted where they occur (the END and NAME directive). 



RELATED PUBLICATIONS 

For further, more detailed information about Intel's 8086/8088 assembly language 
and ASM86 assembler, see the following manuals: 

An Introduction to ASM86, 1 2 1 689 

• ASM86 Macro Assembler Operating Instructions for 8086-Based Development 
Systems, 121628 

or 

• 8086/8087/8088 Macro Assembler Operating Instructions for 8080/8085-Based 
Development Systems, 1 2 1 624 

or 

• MCS-86 Macro Assembler Operating Instructions for ISIS-II Users, 9800641 

For a description of the 8086/8088 architecture and an overview of the ASM86 and 
PL/M-86 languages, see: 

• Morse, Stephen P., The 8086 Primer (2nd Ed), Hayden Book Company, Inc., 
Rochelle Park, New Jersey, 1982. 

For information on the 8086 and 8088 microprocessors and the 8087 Numeric Data 
Processor, see: 

• The 8086 Family User's Manual, 9800722 

• The 8086 Family User's Manual, Numerics Supplement, 121586 

For information on the PL/M-86 programming language and compiler, see: 

• PL/M-86 User's Guide for 8086-Based Systems, 121636 
or 

• PL/M-86 Programming Manual, 9800466 

• PL/M-86 Compiler Operating Instructions for 8080/8085-Based Development 
Systems, 9800478 

For information on the LINK86 and LOC86 utility programs, see: 

• iAPX 86,88 Family Utilities User's Guide, 121616 
or 

• 8086 Family Utilities User's Guide, 9800639 
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CHAPTER 1 

OVERVIEW OF THE ASM86 

ASSEMBLY LANGUAGE 



The 8086/8087/8088 Development Environment 

This chapter presents an overview of ASM86, a macro assembly language for the 
8086 and 8088 microprocessors, optionally in combination with the 8087 Numeric 
Data Processor. The assembler generates object modules, which contain machine 
instructions and data, from programs written in ASM86. Programs may be written 
solely in assembly language or can be a modular combination of ASM86, PL/M-86, 
FORTRAN-86, or Pascal-86 modules. The assembler is part of a family of 
8086/8088 tools, that create a very flexible environment for modular software 
development. Other members of this family of software tools are: 

CONV86— a tool to convert error-free 8080/8085 source files to syntactically 
valid ASM86 source files. It will issue caution and error messages for conver- 
sions that may require editing. 

PL/M-86— -creates object modules from programs written in PL/M-86, a high 
level systems implementation language for the 8086/8088. 

Pascal-86 — creates object modules from programs written in Pascal-86, a high 
level applications language. 

FORTRAN-86— creates object modules from programs written in 
FORTRAN-86, a high level applications language. 

LINK86— combines object modules into load modules. 

LOC86 — binds load modules to absolute memory addresses. 

LIB86— helps build and manage libraries of object modules. 

OH86— converts an 8086/8088 object module to Intel Hex Format. 

ICE™-86— the In-Circuit Emulator for the 8086. 

ICE™-88— the In-Circuit Emulator for the 



This revision of the ASM86 Language Reference Manual includes information on 
the iAPX 186 instructions. These instructions can be used only if you use the 
iAPX 186 assembler. The 186-only instructions are indicated by having iAPX 186 in 
parentheses after the mnemonic. Clocks of iAPX 186 are given in Appendix H of this 
manual. 

The manuals describing the languages and operation of the software relating to the 
8086 Family of components are listed in the preface section of this manual, "How to 
Use This Manual." Figure 1-1 illustrates these tools within the software develop- 
ment environment for the 8086/8087/8088. 



An Overview of the Assembly Language 

The assembly language for the 8086/8088 is used to write and structure programs to 
be assembled, linked, located, and executed on an 8086 or 8088 microprocessor, 
optionally in combination with an 8087 Numeric Data Processor. There are direc- 
tives to control program segmentation, the allocation of data, including structured 
data types, and to structure multi-module programs through relocation and linkage 
directives. The assembly language features a set of operators for assembly-time 
expressions, which allow the user to manipulate and control the data typing in a sim- 
ple way and supply a means to perform assembly time arithmetic. 

A very important feature of the assembly language is its simplified instruction 
mnemonics. Many assemblers require the programmer to remember a different 
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Figure 1-1 . 8086/8087/8088 Development Environment 
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mnemonic for each machine opcode. For example, a "move immediate" would 
require a different mnemonic than a "move memory". The 8086/8088 instruction 
set uses a single mnemonic for each generic instruction type. Thus, all "moves" use 
the mnemonic "MOV". The opcode generated is dependent on the operands sup- 
plied with the instruction. A move from memory could be written: 

MOV AX, COUNT 

where count is a variable. An immediate move would be written as: 
MOV DX, 0A123H 

In each case the mnemonic is the same. This simplification allows the programmer 
to concentrate on the programming task and not on remembering a large set of 
mnemonics. In order to determine the correct instruction to generate, the assembler 
examines the operands and determines their "type" (byte/word, variable/constant, 
etc.) and then uses this information to select the appropriate code. 

The 8086 and 8088 have instructions to manipulate both 8 and 16-bit data. ASM86 is 
a "strongly-typed" language in that it checks that operands in an instruction are of 
the same "type". This prevents the programmer from inadvertantly moving a word 
variable into an 8-bit destination, for example. This would be an error that might 
not be detected until run-time. The assembler will catch this error at the time of 
assembly, saving the programmer the chore of debugging this error. However, one 
of the features of programming in assembly language is the ability to manipulate 
data in every possible way, including the above "illegal" operation. ASM86 has 
many directives and expression operators to override this typing mechanism so that 
these types of operations can be performed (see Chapter 4). 

The assembler allows you to forward reference variables and labels in your program. 
A forward reference is a use of a variable or label prior to its definition. 

MOV AX, COUNT ;forward reference to COUNT 



COUNT DW 15 jdefinition of COUNT 

When you make a forward reference such as that shown above, the assembler must 
make a guess as to the nature of the thing referenced. In this case it will assume that 
it is a word variable because AX is a word register. However, it could be a constant 
if it was defined as: 

COUNT EQU 15 ; d e f i n i t i o n of COUNT as a constant 

It is possible for the assembler to guess wrong or to make a poor guess that could 
lead to an error message or inefficient code. It is recommended that you try to avoid 
forward references as much as possible in your program. A good practice is to define 
all your variables/data at the top of your program. 

Basic Assembly Language Constituents 

This section discusses the elements that constitute a source file in the ASM86 
assembly language. 

Character Set 

The character set used in ASM86 is a subset of both ASCII and EBCDIC character 
sets. The valid characters consist of the alphanumerics: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 

abcdefghijklmnopqrstuvwxyz 
01 23456789 
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along with these special characters 

+ -*/ = ()[]<>;' •",_:? @$& 

and the non-printing characters 

space tab carriage-return line-feed 

If an ASM86 program contains any character that is not in this set, the assembler 
will treat the character as a blank. The combination of a linefeed or carriage- 
return/linefeed immediately followed by an ampersand represents a continuation 
line and is treated as a blank (except within a character string or comment). 

Upper- and lower-case letters are not distinguished from each other (except in 
character strings). For example, xyz and XYz are interchangeable. 

Blanks are not distinguished from each other and any unbroken sequence of blanks 
is considered to be the same as a single blank (except within a character string). 

Special characters and combinations of special characters have particular meanings 
in a program, as described in the remainder of this manual. 

. Tokens and Separators 

A token is the smallest meaningful unit of a source program, much as words are the 
smallest meaningful units of a book in English. Separators are used to separate two 
adjacent tokens so that they are not mistakenly thought to be one longer token. The 
most commonly used separator is the blank. Any unbroken sequence of blanks may 
be used wherever a single blank is allowed. Horizontal tabs are also used as 
separators and are interpreted by the assembler identically to blanks except that they 
may appear as multiple blanks in the list file (see operator's manual). Any illegal 
character, or character used in an illegal context, is also treated as a separator. 

Delimiters 

Delimiters are special characters that serve to mark the end of a token and also have 
a special meaning unto themselves (as opposed to separators, which merely mark the 
end of a token). Commas, plus-signs, square brackets, etc., all serve as delimiters. 
When a delimiter is present, separators need not be used; however, using separators 
often makes your programs easier to read and, therefore, easier to understand. 

Identifiers 

An identifier is used to name a user-defined entity in a program. This could be a seg- 
ment, a group, a variable, a label, or a constant defined with an EQUate directive. 
The format for an identifier is as follows: 

1 . The identifier must begin with a letter or one of three special characters: 

a. A question mark (?), with hexadecimal value 3FH. 

b. A commercial at-sign (@), with hexadecimal value 40H. 

c. An underscore ( ), with hexadecimal value 5FH. 

2. It may contain letters or digits and the three special characters. 

3. The identifier name is considered unique only up to 31 characters, but it can be 
of any length (up to 255 characters). 

4. Every identifier has global scope within your program module. 
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Statements 

Just as tokens may be seen as the assembly language counterparts to the English con- 
cept of words, so may statements be viewed as analogous to sentences. A statement 
is a specification to the assembler as to what action to perform. In fact, one way of 
viewing a computer program is as a sequence of statements which, when taken as an 
aggregate, is intended to perform a particular function. Statements may be divided 
into two types: 

Instructions: these are translated by the assembler into machine instruction code 
which "instruct" the 8086/8087/8088 to perform certain operations. 

Directives: these are not translated into machine instruction code by the assembler 
but rather "direct" the assembler itself to perform certain clerical functions. 

Usually a statement will occupy one "line" in your source file. A "line" is a 
sequence of characters ended by a terminator (line-feed or carriage-return/line-feed 
combination). However, ASM86 provides for "continuation lines" which allow a 
statement to occupy more than one physical line in your source file. Any statement 
may be continued if the first character following the terminator is an "&". (Sym- 
bols, however, may NOT be broken across continuation lines. Character strings may 
not be continued across continuation lines; the string must be closed with an 
apostrophe on one line and then reopened with an apostrophe on a subsequent con- 
tinuation line, with an intervening ",". Comments are considered to be ended by a 
terminator; if a comment is continued then the first non-blank character following 
the "&" must be a";".) 

An Overview of the Macro Language 

The assembler contains as its front-end a macro processor. The macro processor 
scans the source file for macro definitions and macro calls written in Macro Pro- 
cessor Language (MPL). Macro calls are expanded according to macro definitions, 
and the resulting source assembly language is assembled by the assembler. By using 
MPL, you can create macros specific to your application that can generate 
sequences of assembly language instructions or directives. The macro processor is a 
very powerful string replacement facility that can help to simplify a programming 
task. Repeatedly used code sequences can be replaced by a simple macro call. Also, 
frequently used assembler directive statements can be replaced by macro calls. 
Details for the use of MPL are in Chapter 7. 

CPU Hardware Overview 

For a complete understanding of the architecture of the 8086/8088, the reader 
should become familiar with Chapters 1 and 2 of The 8086 Family User's Manual, 
9800722-03). The 8086 and 8088 execute exactly the same instructions. The instruc- 
tion set includes arithmetic and logical, program transfer, and data transfer opera- 
tions. It also includes some new operations not found on previous Intel micro- 
processors. These include: 

• Multiplication and division of signed and unsigned binary numbers as well as 
unpacked decimal numbers. 

• Move, scan, and compare operations for strings up to 64K bytes in length. 

• Non-destructive bit testing. 

• Byte translation from one code to another. 

• Software-generated interrupts. 

• A group of instructions that can help coordinate the activities of multiprocessor 

systems. 
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This section will give a broad overview of the machine architecture by presenting the 
register set for the 8086/8088. The 8087 is discussed in Chapter 6. 



The General Register Set 



The 8086/8088 has a set of eight 16-bit general registers. These general registers are 
subdivided into two sets of four registers. The first set is called the data registers. 
Each 16-bit data register is further divided into two 8-bit registers, allowing its upper 
(high) and lower halves to be separately addressed. This means that each data 
register can be used interchangeably as a 16-bit register, or as two 8-bit registers. 
Each of these 16-bit and 8-bit registers can participate in arithmetic and logical 
operations. The data register set is given below: 



16-Bit Register 



8-Bit Registers 
High Low 



AX 
BX 
CX 
DX 



AH 
BH 
CH 
DH 



AL 
BL 
CL 
DL 



The second set of general registers consists of the pointer and index registers. These 
registers can participate in most of the same 16-bit arithmetic and logical operations 
as the data registers. In most cases, however, these registers are used as pointer or 
index registers for addressing data objects in memory. The addressing modes 
available on the 8086/8088 are discussed in Chapter 4. These registers are: 

BP — base pointer 
SP — stack pointer 
SI — source index 
DI — destination index 
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Figure 1-2. The General Register Set 
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Some of the 8086/8088 instructions make implicit use of general registers. Table 1-1 
lists the general types of instructions which use these registers. You should refer to 
the complete description of each instruction given in Chapter 6 for a discussion of 
this implicit use. 

Table 1-1 . Implicit Use of General Registers 



Register 


Operations 


AX 


Word Multiply, Word Divide, Word I/O 




AL 


Byte Multiply, Byte Divide, Byte I/O, Translate, 


Decimal Arithmetic 


AH 


Byte Multiply, Byte Divide 




BX 


Translate 




CX 


String Operations, Loops 




CL 


Variable Shift and Rotate 




DX 


Word Multiply, Word Divide, Indirect I/O 




SP 


Stack Operations 




SI 


String Operations 




Dl 


String Operations 





The Segment Register Set 

The 8086/8088 is capable of addressing a megabyte of memory. This megabyte can 
be accessed through four segments by the CPU. Each segment is 64K bytes in size. 
The four segment registers (CS, SS, DS, ES) indicate the base locations for these 
segments. The four segments are functionally defined as containing code, data (two 
segments), and the hardware stack. The CS register points to the current code seg- 
ment, from which instructions are fetched. The SS register points to the current 
stack segment. All hardware stack operations are performed on locations in this seg- 
ment. The DS register points to the current data segment that generally contains pro- 
gram variables. The ES register points to the current extra segment; it is typically 
used for data storage. These registers are accessible to programs and can be 
manipulated by several instructions. 



Figure 1-3. The Segment Register Set 
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The 8086/8088 Memory Segmentation Model 

The 8086/8088 can address a megabyte of memory (1,048,576 bytes). This memory 
space is viewed by the CPU at run-time as four functional portions called physical 
segments. Each physical segment is dedicated for a particular use. One is dedicated 
to contain code, one for data, one for the hardware stack, and an extra segment that 
is usually used for data. 

A segment register contains a 16-bit value, used to point to the start or base of a 
physical segment. The contents of a segment register determine the upper 16 bits of a 
20-bit address. Thus, each physical segment must begin at an address whose low 
four bits are zero. Such a location is called a 'paragraph boundary.' The value in a 
segment register is called a 'paragraph number.' Thus the location 12340H is 
indicated by paragraph number 1234H. For a segment register to point to this loca- 
tion (denoting the start of a physical segment at that location) it would be loaded 
with the value 1234H defining a 64 K segment starting at absolute address 12340H. 

It requires 20 bits to address a megabyte of memory. The 20 bits are composed from 
two portions by the CPU. The first portion is the 16-bit paragraph number discussed 
above. It specifies where the physical segment begins in memory. Another quantity 
is required to specify the location of a particular object within that physical segment. 
This quantity is called the offset portion of the address. It defines a location at a 
specific offset from the start of the physical segment. Each offset is a 16-bit 
quantity, allowing you to address up to 64K bytes in a physical segment. 

How then does the hardware generate a 20-bit address from these two values? First, 
the paragraph number in the appropriate segment register is multiplied by 16 
(shifted left 4 bits). The result is then added to the offset yielding the 20-bit address 
(see figure 1-4). The hardware automatically performs this operation. You, however 
must ensure: 1) that the correct paragraph number is loaded into the correct segment 
register and 2) that the instruction uses the correct offset value. The first is usually 
handled by some initialization code at the start of the program or by the loader. The 
second is handled by the assembler, as long as the instruction is correctly coded. 

The assembler, while assembling the source file, is producing code/data for only one 
segment at a time. Within a segment, the assembler needs only to keep track of the 
offset of an object, whether it be code or data. The offset is referred to as the "loca- 
tion counter," which may be user programmable. This same situation is true during 
the execution of a program; only one segment is active at a given time for either code 
or data. Once a segment register is set with the base of a particular segment, objects 
within that segment can be referred to using only their offsets within that segment. 
Because of the segmentation model used, the programmer is usually only 
manipulating the offset part when coding an instruction. 
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An important concept to keep in mind while programming the 8086/8088 is 
'addressability.' The object in memory which you are referencing must be address- 
able at run-time. This means that the appropriate segment register contains the base 
of the segment in which the object is located. You must insure that the proper value 
is loaded into a segment register before the object is referenced by an. instruction. 
This is accomplished by using the appropriate sequence of instructions to initialize 
the segment register. There are assembler directives described in Chapter 2, which 
help to insure that you are aware of the addressability of data and code while writing 
a program. The following example shows the definitions of two segments, one for 
data and one for code. In the code segment, there is an illustration of the type of 
code that is used to initialize a segment register. 



Example: 

DATA SEGMENT 

ABYTE DB 
DATA ENDS 
ASSUME CS:C0DE, D S : D A T A 



CODE SEGMENT 

MOV 
MOV 



AX, DATA 
DS, AX 



define a segment for data 

some data ! 

end of segment definition 

defines the addressability 
of the contents of these 
segments 

define a segment for code 

AX = base address of DATA 
segment, initialize DS, data 
now addressable through DS 



CODE ENDS 



;end of segment definition 



A source module is a separately assembled or compiled source file. An executable 
program can be made up of one or more modules. A single module can define 

1. A part of a physical segment. 

2. A complete physical segment. 

3. Parts of several physical segments. 

4. Several complete physical segments. 

A physical segment is composed of one or more 'logical segments.' These are defini- 
tions of segments made in your program through the use of assembler directives 
designed for this purpose. You can specify a set of logical segments and their con- 
tents (code, data, etc.) and control how they are combined into physical segments. 
The mechanism for accomplishing this task is discussed in Chapter 2. 



A Description of the Format Used for Directive 
Specifications 

The chapters that follow will discuss the form and use of the assembler directives. 
The following describes the format used to specify how each directive is written and 
the meaning and use of the different fields that can be part of a directive. 
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A. Syntax 

The following notation is used to show the syntax of the directives. 

1. Lower case strings represent fields that can be replaced either by user-supplied 
strings (such as names) or by assembler keywords. These items are referred to as 
Field Values. The actual replacement values are specified for each directive in 
the sections entitled Field Values. 

2. Upper case strings represent assembler keywords (e.g., SEGMENT, DB, END, 

or NAME). 

3. Optional items are shown in brackets, i.e., [item]. These items are optional in 
the syntax. Use of these fields is specified for each directive. In some cases the 
absence of this item ("none specified") denotes a default case, which is noted 
where appropriate. 

4. The item [,...] represents the optional repetition of a specific item. The syntax 
thing [ ; ... ] 

would expand to 

thing, thing, thing, ... 

The actual number of items that can appear in the list is typically limited by con- 
straints internal to the assembler. 

B. Description 

This section is a paragraph which describes the meaning and use of the directive. 

C. Field Values 

This section describes the values used in specific fields shown in the syntax of the 
directive. Upper case strings denote assembler keywords. 

D. Additional Notes 

After the above sections, there may be sections dealing with important considera- 
tions, concepts, or applications of the particular directive. These sections should be 
read carefully. 
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The 8086/8088 directly addresses one megabyte of memory. This megabyte is viewed 
by the CPU through four segments, each containing up to 64K bytes. These four 
segments are called physical segments. The start of each segment is defined by the 
value placed in a segment register. This value is called a paragraph number. It 
defines a paragraph boundary in memory, an address divisible by 16 (least signifi- 
cant hexadecimal digit is equal to OH). 

The four segments are classified as code, data, stack, and extra. They are defined by 
the four segment registers: 

CS for code 

DS for data 

SS for stack 

ES for extra 

Executable instructions will be in a physical segment defined by the value in CS. Any 
stack operations will occur within the segment defined by SS. Data is normally 
found in the segment defined by DS, but it can also be placed in the segments 
defined by the other segment registers. The contents of the physical segments in 
memory during the execution of a program are defined through the assembly 
language as logical segments. A physical segment can contain any number of logical 
segments that were specified in the program source code (either one or more 
modules). The SEGMENT directive is used to both define a logical segment and to 
control how the segments will be combined to form a physical segment. The 
GROUP directive is another way to combine logical segments with certain restric- 
tions. Because all code and data must lie within some physical segment during pro- 
gram execution, a way to specify this addressability is required during assembly time 
to check for this condition. The ASSUME directive serves this purpose. 

The SEGMENT/ENDS Directive 

Syntax: 

name SEGMENT [align-type] [combine-type] ['classname'] 



name ENDS 

Description: 

The SEGMENT/ENDS directive is used to define a logical segment. This segment 
may be combined with other segments in the same module and/or with segments 
defined in other modules. These segments will form the physical segments, located 
in memory, that are pointed to by the segment registers. The programmer will place 
within the SEGMENT/ENDS pair the code, data, or stack. Within a source module, 
each occurrence of an equivalent SEGMENT/ENDS pair (with the same name) is 
viewed as being one part of a single program segment. 
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Field Values: 

name 

The name for the segment, a unique ASM86 identifier. 

[align-type] 

This field specifies on what type of boundary in memory the segment will be 
located. 

The values it may have are: 

1. None specified — the default value of paragraph alignment. The segment 
will begin on an address divisible by 16 (i.e., an address whose least signifi- 
cant hexadecimal digit is equal to OH). 

2. PARA— paragraph alignment (same as default). 

3. BYTE — byte alignment; segment may start at any address. 

4. WORD— word alignment; segment will start at an even address (i.e., least 
significant bit equal to OB). (See EVEN directive, page 3-19.) 

5. PAGE— page alignment; segment will start at an address whose two least 
significant hexadecimal digits are equal to 00H. 

6. INPAGE— inpage alignment; the entire segment must fit within 256 bytes 
and, when located, must not overlap a page boundary (i.e., 00H, 100H, 
200H, ... ,0FF00H). 

[combine-type] 

This field specifies how the segment will be combined with segments from other 
modules to form a physical segment in memory. The actual combination will 
occur during the LINK86 and LOC86 phase of development. The values for this 
field are: 

1 . None specified — the default value of non-combinable. The segment will not 
be combined with any other segment. (Note, however, that separate pieces 
of this segment in the same module will be combined.) 

2. PUBLIC — all segments of the same name that are defined to be public will 
be combined (concatenated to form one physical segment). The order of 
combination is controlled during the use of LINK86. The length of the 
resulting physical segment will equal the sum of the lengths of the segments 
combined. 

3. COMMON — all segments of the same name that are defined to be common 
will be overlapped to form one physical segment; all of the combined 
segments begin at the same physical address. The length of the physical seg- 
ment will be equal to the length of the largest segment combined. 

4. STACK— all segments of the same name that are defined to be stack will be 
combined into a physical segment so that each combined segment will end 
at the same address (overlaid against high memory) and will grow 
"downward." The length of the stack segment after combination will equal 
the sum of the lengths of the segments combined. 

5. MEMORY — all segments of the same name that are defined to be memory 
will be combined so that the first memory segment encountered by LINK86 
will be treated as the physical "memory" segment. In the list of modules 
linked together by LINK86, the first module that contains a "memory" seg- 
ment will be used to define the physical "memory" segment. It will be 
located at an address above all other segments in the program. Any other 
segments of the type memory that are encountered by LINK86 will be com- 
bined as common with the first segment. The length of the memory segment 
will be equal to the length of the first memory segment encountered. 
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6. AT expression — this is an absolute physical segment to be located at the 
memory address defined by the expression. This expression will represent a 
paragraph number. For example, if the expression is 4444H, then the seg- 
ment will be located at paragraph number 4444H or absolute memory 
address 44440H. The expression must evaluate to a constant (see Chap- 
ter 3). No forward references are allowed. 

['classname'] 

The classname is used to indicate that segments are to be located (by LOC86) 
near each other in memory. This is not a means of combining segment so that 
they are addressable from the same segment register. The classname indicates 
that certain uncombined segments are to be put in the same general area in 
physical memory (for example, ROM). 

Example: 

The following two segments will be located adjacent to one another— 

DATA1 SEGMENT BYTE 'ROM' 

DATA1 ENDS 

DATA2 SEGMENT BYTE 'ROM' 

DATA2 ENDS 



Multiple Definitions; for a Segment 

You may "open" and "close" a segment (with SEGMENT and ENDS directives) 
within the module as many times as you wish. All "parts" of the segment which you 
define are treated together by the assembler as parts of one segment. 



The following two occurrences of the segment DATA— 

DATA SEGMENT PUBLIC 

ABYTE DB 
AWORD DW 

DATA ENDS 

DATA SEGMENT PUBLIC 

ANOTHERBYTE DB 
ANOTHERWORD DW 

DATA ENDS 
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are equivalent to— 

DATA SEGMENT PUBLIC 

ABYTE DB 

AWORD DW 

ANOTHERBYTE DB 

ANOTHERWORD DW 

DATA ENDS 

When you re-open a segment, you do not need to re-specify its attributes. However, 
you cannot change its attributes. The following is correct: 

CODE SEGMENT BYTE PUBLIC 

CODE ENDS 

CODE SEGMENT 

CODE ENDS 

The following will be flagged as an error: 

DATA SEGMENT WORD 'ROM' 

DATA ENDS 

DATA SEGMENT BYTE 'ROM' 

DATA ENDS 



"Nested" or "Embedded" Segments 

Segments are never physically nested or embedded in memory. However, you may 
nest segment definitions in your program. This is only a lexical nesting and does not 
represent a physical nesting. For example, the following is a legal construct: 

CODE SEGMENT ;begin CODE 



DATA SEGMENT ; begin DATA, stop assembling CODE 
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DATA ENDS ;end DATA, begin assembling CODE 
; a g a i n 



CODE ENDS ;end CODE 

The assembler will treat the CODE segment separate from the DATA segment. The 
contents of the DATA segment are not contained within the CODE segment. The 
following will be flagged as an error because SEGMENT/ENDS pairs must be 
matched as shown above: 

CODE SEGMENT ;begin CODE 



DATA SEGMENT ;begin DATA 



CODE ENDS ;an error!!! Cannot close CODE before 

; closing DATA 



DATA ENDS 

The Default Segment— ??SEG 

All variables and instructions must lie within some segment at run-time. If you do 
not specify a segment to contain your code or data, the assembler will create a seg- 
ment named ??SEG, in which this code or data will lie. This segment is non- 
combinable and paragraph aligned. 



The ASSUME Directive 

Syntax: 

ASSUME segreg:segpart [, ... 

or 

ASSUME NOTHING 



Description: 

At run-time, every memory reference (a variable or label) requires two parts in order 
to be physically addressed: a paragraph number (segment part) and an offset (within 
the segment). The paragraph number will be in one of the segment registers, defining 
the physical segment in which the variable or label lies. (This value will have been 
placed in the segment register by the appropriate initialization code.) The offset 
value will be contained in the instruction which makes the reference. These two 
values are used to compute the absolute address of the object referenced. You use 
the ASSUME directive to define what the contents of the segment registers will be at 
run-time. This is done to help the assembler ensure that the code or data referenced 
will be addressable. The assembler will check each memory reference for address- 
ability based on the contents of the ASSUME directive. The ASSUME directive does 
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not initialize the segment registers; it is used by the assembler to help you to be aware 
of the addressability of the code and data. Unless the code or data is addressable (as 
defined either by an ASSUME or a segment override) the assembler will report an 
error. The ASSUME directive also helps the assembler decide when to automatically 
generate a segment override instruction prefix. (See Chapter 4 on the Segment Over- 
ride Prefix.) The following example illustrates the use of ASSUME — 



ASSUME DSrDATA, CS : CODE 

DATA SEGMENT PUBLIC 

ABYTE DB 
AWORD DB 

DATA ENDS 

DATAX SEGMENT PUBLIC 

WHERE DB 

DATAX ENDS 

CODE SEGMENT PUBLIC 

MOV AX, DATA 
MOV DS, AX 

MOV AL, ABYTE 



ALAB: MOV AWORD, 15 
JMP ALAB 



;the DATA segment is 

; addressable through DS and 

;the CODE segment through CS 



MOV 



AH, WHERE 



MOV AX, DATAX 
MOV ES f AX 

ASSUME ES : DATAX 

MOV AH, WHERE 

CODE ENDS 



;AX = base address of DATA 
; initialize D S 

DS points to base of DATA 
segment that contains ABYTE. 
Instruction will use offset of 
ABYTE to address value 

CS points to base of CODE 
CS initialized when program 
loaded, instruction will use 
offset of ALAB to calculate 
j ump 

AN ERROR!!!!! DS has not been 
initialized with the base 
address of the segment DATAX 
and no ASSUME has been made! 
The assembler does not know 
where WHERE i s . 



; initialize E S 

; DATAX now in ES 

assembler will automatically 
assemble an ES instruction 
prefix to address WHERE 
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Field Values: 

segreg 

One of the 8086/8088 segment register names: CS, DS, SS, or ES. 

segpart 

This field defines a paragraph number in one of the following ways: 

1 . A segment name, as in: 

ASSUME CS : CODE , DS : DATA 

2. A previously defined group name (see page 2-8), as in: 
ASSUME CSrCODEGRP, DS : DATAGRP 

3. An expression(see page 4-18) of the form: 

SEG variable-name or SEG label-name or SEG external-name, 
as in: 

ASSUME CS : SEG START, DS : SEG COUNT 

4. The keyword NOTHING, which states that nothing is defined to be in that 
segment register at that time. If a segment register is assumed to contain 
NOTHING, the assembler will not generate instructions that use this seg- 
ment register for memory addressing. 

Example: 

ASSUME ES : NOTH ING 

The form ASSUME NOTHING is equivalent to: 

ASSUME CS : NOTH ING # DS : NOTH ING , SS : NOTH ING , ES : NOTH ING 

This is the default, which remains in effect until the first ASSUME directive 
is seen. 



Forward Referenced Names in an ASSUME Directive 

You may forward reference a name (i.e., refer to name not yet defined) in an 
ASSUME directive only if that name is the name of a segment. This is in the form: 



ASSUME CS:C0DE ;The name CODE is a forward reference 
CODE SEGMENT ; C D E defined here 

CODE ENDS 

If the name is not the name of a segment, an error will be reported. 
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Multiple ASSUME Directives 

An ASSUME directive will stay in effect until it is changed by another ASSUME. 
That is, if you assume some contents in CS, that assumption will hold until you 
assume some new contents or NOTHING in CS. 

The GROUP Directive 

Syntax: 

name GROUP segpart [,...] 

Description: 

The GROUP directive is used to combine several logical segments together, so that 
they will form one physical segment (i.e., they will all be addressable from the same 
base) after the program has been located. The size of the group is equal to the sum of 
the sizes of all the segments specified in the GROUP directive. The total size must be 
less than or equal to 64K bytes. The assembler will make no checks to see if the size 
of the group will be correct. This check is made by LOC86. The group name can be 
used as if it were a segment name (except in another GROUP directive). The order of 
the segments in the group directive will not necessarily be the order of the segments 
in memory after the program is located. 

The GROUP directive serves as a "shorthand" way of referring to a combination of 
segments. Its utility is in specifying a collection of segments that are to be grouped at 
link-time to form one physical segment. However, the assembler views the program 
content in terms of segments. When you define a variable or label (see Chapter 3), 
the assembler assigns that variable or label to the segment in which it was defined. 
The offset associated with the variable or label is from the base of its segment and 
not from the base of the group. 

One use of the group name is in the ASSUME directive. If, for example, you have 
defined many different data segments that you intend to form into one physical seg- 
ment when the program is located in memory, you could combine these segments 
with the GROUP directive. Since the contents of all these data segments will be 
addressable through DS during the execution of the program, you may use the group 
name in the ASSUME and to initialize DS. For example, 



DATAGRP GROUP DATA1 , DATA2 

DATA1 SEGMENT 

ABYTE DB 

DATA1 ENDS 

DATA2 SEGMENT 

AWORD DW 

DATA2 ENDS 

ASSUME DS:DATAGRP, DS : CODE ;use group name in ASSUME 

CODE SEGMENT 
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MOV AX, DATAGRP ;AX = base address of group 
MOV DS, AX ; initialize DS 

MOV AX, AWORD ;addressable through DS 



CODE ENDS 

Field Values: 

name 

A unique ASM86 identifier that is used as the name for the group. 

segpart 

The field defines a paragraph number in one of the following ways: 
1 . A segment name, as in: 

CODEGRP GROUP C0DE1 , C0DE2 

2- An expression (see page 4-18) of the form: 

SEG variable-name or SEG label-name or SEG external-name, 
as in: 

DATAGRP GROUP SEG START, SEG COUNT 



Use of the OFFSET Operator With Groups 

When using the OFFSET operator (see page 4-18) with a variable or label whose seg- 
ment is in a group, you must use the group name as a segment override (see page 
4-14) in the expression, as in: 

MOV BX, OFFSET DATAGRP : COUNT 

Also, if you wish to store the paragraph number of a variable or label, you must use 
this construct: 

DW DATAGRP:COUNT 
DD DATAGRPrCOUNT 
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Overview of Variables and Labels 

The two most referenced objects (other than registers) in a program are variables 
and labels. You define these objects in your program. Variables refer to data items, 
areas of memory where values are stored. Labels refer to sections of code that may 
be jumped to or CALLed. Each variable and label has a unique name in your 
program. 

A variable is defined through a data definition statement or the LABEL directive. 
Each variable has three attributes: 

1. Segment — The segment in which the variable was defined. It is a value that 
represents the paragraph number of the segment. 

2. Offset— The offset (current location counter) of the variable defined. It is a 
16-bit value which represents the distance in bytes from the base (or start) of the 
segment to the start of the variable in memory. 

3. Type — The size of the data item in bytes. In most cases this type is specified 
through a keyword in the definition. The type of a variable determines how it 
may be used in an instruction and also, in some cases, how data will be stored 
within that variable. The possible types are: 

1 . BYTE— one byte— 8086/8088 data types. 

2. WORD— one word (two bytes)— 8086/8088 data types. 

3. DWORD— one double-word (four bytes)— 8086/8088 or 8087 data types. 

4. QWORD— one quad-word (eight bytes)— 8087 data types. 

5. TBYTE— one ten-byte (ten bytes)— 8087 data types. 

6. A structure— a multi-byte, "structured" 8086/8088 data type. 

7. A record— an 8 or 16 bit, "bit-encoded" 8086/8088 data type. 

When you define a variable, the assembler will store its definition, which includes 
the above attributes. In Chapter 4, there is a discussion of expression operators that 
allow you to obtain or to override these attributes. 

Labels define addresses for executable instructions. They represent a "name" for a 
location in the code. This "name" or label is a location that can be jumped to or 
CALLed. The label is an operand of the CALL, JMP, and conditional jump instruc- 
tions. A label can be defined three ways: 1) a name followed by a ":" associated 
with an instruction statement, 2) a PROC directive, or 3) with a LABEL directive. 
Like a variable, a label has three attributes, two of which are the same as those for a 
variable: 

1 . Segment — same as variable. 

2. Offset— same as variable. 

3. Type— for a label, the type specifies the type of jump or CALL that must be 
made to that location. There are two types: 

1. NEAR— this type represents a label that will be accessed by a jump or 
CALL that lies within the same physical segment. This type of access is 
referred to as an intra-segment jump or CALL. In this case, only the offset 
part of the label is used in the jump or CALL instruction. 
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2. FAR — this type represents a label that will be accessed from another 
segment. In this case, because control is transferred from one physical seg- 
ment to another, the contents of the CS register must be changed by the 
jump or CALL. A far label will be represented in the jump or CALL 
instruction by its offset and its segment part (to be loaded into CS). 

A special form for defining a label is the PROC directive. This form specifies a 
sequence of code that will be CALLed just as a subroutine in a high-level language. 
The PROC directive defines a label with a type, either NEAR or FAR. It also defines 
a context for the RET instruction so that the assembler can determine the type of 
RET to code (either a near RET or a far RET). This construct can help to structure 
your programs into clearly defined subroutines. But, unlike high-level language pro- 
cedures, there is no scoping of names and you can "fall into" an imbedded 
"procedure." (See page 3-15.) 

Constants 

A constant is a pure number without any attributes. In general, a constant can be 
binary, octal, decimal, hexadecimal, ASCII, decimal real, or hexadecimal real. A 
constant can evaluate to one of three types: 8-bit, 16-bit, or real. These types cannot 
necessarily be used in the same context. You should verify the correct use of con- 
stants. The assembler will report an error if a constant is used incorrectly. The pro- 
per contexts for a particular type are noted throughout this manual. Table 3-1 gives 
the rules for forming each type of constant. A constant that can be represented in 8 
or 16 bits has a special internal representation in the assembler. These constants are 
referred to as '17-bit numbers.' The maximum range of values for these numbers is 
-OFFFFH to OFFFFH. All assembly time expressions use two's complement 
arithmetic on 17-bit numbers. Real constants (or floating point numbers) are 
restricted to DD, DQ, DT, and EQU directives. (For further information on the use 
of reals and the 8087 see The 8086 Family User's Manual Numeric Supplement, 
121586-001.) 

There is a special set of constants that are used in programming for the 8087. In 
general, these constants are referred to as "reals." The actual types are: 

1 . Short integer — four bytes. 

2. Short real — four bytes. 

3. Long integer — eight bytes. 

4. Long real — eight bytes. 

5. Packed decimal number— ten bytes. 

6. Temp-real — ten bytes. 

A short, long, or temp-real can be expressed in three ways: 

1 . Decimal real — without exponent. 

1.234 

3.14159 

98.6 

1234.4321 

1. 

2. Decimal real — with exponent. 

6.8E27 

1.23E-3 

1E6 

3. Hexadecimal real. 

40490FDBR 
0C0000000R 



3-2 



ASM86 



Defining and Initializing Data 



Integers (includes packed decimal) can be expressed in either binary, octal, decimal, 
or hexadecimal notation. The type of data allocation (the directive) you choose will 
affect the range of values that can be used in the initialization. These ranges are 
noted below under the appropriate directive. 

Table 3-1 . Constants 



Constant Type 


Rules for Formation 


Examples 


Binary 
(Base 2) 


A sequence of 0's and 1's followed by the 
letter 'B' 


11B 
10001111B 


Octal 
(Base 8) 


A sequence of digits through 7 followed 
by either the letter '0' or the letter 'Q' 


77770 
4567Q 
77777Q 


Decimal 
(Base 10) 


A sequence of digits though 9, option 
ally followed by the letter 'D' 


3309 
3309D 


Hexadecimal 
(Base 16) 


A sequence of digits through 9 and/or 
letters A through F followed by the letter 
'H'. (Sequence must begin with 0-9) 


55H 
2EH 

OBEACH 
OFEH 


ASCII 


Any ASCII string enclosed in quotes 
(More than 2 chars, valid for DB only.) 


'A'.'BC 
'UPDATE. EXT' 


Decimal Real 
(Base 10) 


A decimal fraction, optionally followed by 
an exponent. The fraction is a sequence 
of digits through 9. A decimal point is 
required if no exponent is present and is 
optional otherwise. The exponent starts 
with an E, followed by an optional sign 
and digits from 0-9. 


3.1415927 
.002E7 
1E-32 
1. 


Hexadecimal 
Real (Base 16) 


A sequence of digits 0-9 and/or letters A 
through F followed by the letter R. The 
sequence must begin with 0-9. Total 
number of digits must be (8, 16, 20) or (9, 
17, 21). If odd numbered, the first digit 
must be 0. 


40490FDBR 
0C0000000R 



Defining and Initializing Variables 
(DB, DW, DD, DQ, DT Directives) 

Syntax: 

1 byte initialization: 
[name] DB init [,...] 

2 byte initialization: 
[name] DW init [,...] 

4 byte initialization: 
[name] DD init [, ... ] 
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8 byte initialization: 
[name] DQ init [, ... ] 

10 byte initialization: 
[name] DT init [,...] 

Description: 

The DB, DW, DD, DQ, and DT directives are used to define variables and/or 
initialize memory. When the directive is used with a name, it specifies a named 
variable whose segment part is the current segment and whose offset is the current 
location counter. Its type depends on the type of data initialization statement used. 
The variable can be initialized to a value, as in: 

COUNT DB 10 ; a variable initialized to 10 

or it can simply reserve space with no specific initial value: 

FLAGS DW ? jreserve a word 

You may also use these directives to define the contents of memory when the pro- 
gram is loaded. To specify 10 bytes of 0, you might code 

DB 0,0,0,0,0,0,0,0,0,0 

or 

DB 10 DUP (0) ;a DUP is a repeated initialization 

There are many types of values that can be used to initialize data. The following is a 
list of the possible types of initialization: 

1 . Constant expressions — a numeric value. 
TEN DB 10 

2. Indeterminate initialization. 
RESERVE DW ? 

3. An address expression — the offset or base part of a variable or label. 

POINTER DW COUNT ;store offset of COUNT 

SEGBASE DW DATA ; store base address of DATA 

; segment 

APTR DD COUNT ; store offset and segment part 

;of COUNT 

4. An ASCII string of more than two characters — DB only. 
MESSAGE DB 'HELLO THERE' 

MYHERO DB ' ALEISTER CROWLEY' 

5. A list of initializations. 

STUFF DB 10, 'A STRING' ,0, 'Q' 
NUMBS DW 1, 2, 3, 4, 0FFFFH 
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6. A repeated initialization, where the quantity in the '( )' is repeated 'number 
DUP' times. 

TENS DB 10 DUP (10) 

PATTERN DW 100 DUP (0,1 ,65535) 

When a number is stored in 16 bits, it is stored with its low-order byte preceding the 
high-order byte in memory. For example, if you were to code 

DW 1234H 

it would be stored as 

34 12 

low high 

> increasing memory addresses 

in memory. If you specify a string in a DB directive it will be stored with one ASCII 
character per byte in the same order as the characters appear in the string. 

DB 'ABC 

is stored as 

41 42 43 

in memory. 

Field Values: 

[name] 

A unique ASM86 identifier. It defines a variable whose offset will be the current 
location counter. Its type will be the type of the data initialization unit. Its 
length will be equal to the number of bytes initialized. 



mit 



There are many possible values for init depending on the usage and context. Init 
has five possible types, listed below. The form used will depend on what type of 
initialization you wish to perform. The different forms and contexts are noted 
below. 

1. A constant expression. 

a. 1 byte initialization — a constant or expression that evaluates to 8-bits 
(i.e., -255 to +255 decimal). 

b. 2 byte initialization— a constant or expression that evaluates to 16-bits 
(i.e., -65535 to +65535 decimal). 

c. 4 byte initialization — 

1. A constant or expression that evaluates to 16-bits (a 17-bit 
number). The upper 16 bits are sign-extended in assemblers that 
support the 8087, else they are initialized to OH. 

2. Short integer in the range ~2 32 +1 to +2 32 -1, which is -4 294 967 
295 to +4 294 967 295 

3. Real in the range -2 128 to -2 126 , 0, +2~ 126 to +2 128 , or approximately 
-3.4E38 to -1 .2E -38, 0, 1.2E -38 to 3.4E38. 
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ABYTE 


DB 


? 


A WORD 


DW 


? 


ADWORD 


DD 


? 


AQWORD 


DQ 


? 


ATBYTE 


DT 


? 
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d. 8-byte initialization — 

1. Long integer in the range -2 64 +1 to +2 64 -1, which is -18 446 744 
073 709 551 615 to +18 446 744 073 709 551 615. 

2. Real in the range -2 1024 to -2~ 1022 , 0, +2' 1022 to +2 1024 , or 
approximately -1 .7E308 to -2.3E -308, 0, 2.3E -308 to 1 .7E308. 

3. A constant (17-bit number), which will be sign-extended to fit in a 
DQ field. 

e. 10-byte initialization — 

1. Long integer in the range -10 18 + 1 to +10 18 -1, which is 
-999999999999999999 to +999999999999999999. The number will 
be stored as packed decimal (BCD) format. 

2. Real in the range -2 16384 to -2" 16382 , 0, +2" 16382 to +2 16384 , or 
approximately -1.1E4932 to -3.4E-4932, 0, 3.4E-4932 to 
+ 1.1E4932. 

2. The character '?' for indeterminate initialization. 

In situations where you wish to reserve storage but do not need to initialize 
that area to any particular value, you can use the special character "?". 
This character specifies that the area will be reserved. The reserved area will 
be initialized with an indeterminate value. It can be used with any of the 
data initialization directives. 

reserve a byte 
reserve a word (2 bytes) 
reserve a dword (4 bytes) 
reserve a qword (8 bytes) 
reserve a tbyte (10 bytes) 

When used in a special DUP construct, "?" can be used to specify no 
initialization (see below). 

3. Initializing with an address-expression— DW and DD only. 

You can initialize a DW or DD with a variable name, label name, segment 
name, or group name. When you use a variable or label name in a DW, you 
are initializing with the offset of that variable or label. 

DW COUNT ;store the offset of COUNT 

;from its segment 
DW DATAGRPrCOUNT ;store the offset of COUNT 

;from its group (DATAGRP) 

Using a segment name or group name in a DW will store the paragraph 
number of that item. 

DW CODE ; store the paragraph number of CODE 
; segment 

In a DD, the use of a variable or label name will store the offset of the 
variable or label in the lower order word and the segment part (paragraph 
number) in the higher order word. This forms a pointer to that item. 

DD COUNT ;store a pointer to COUNT 

which is equivalent to: 

DW COUNT ;store the offset of COUNT 
DW SEG COUNT ; store the paragraph number of 

; COUNT'S segment 
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Use of segment or group name in a DD will store the paragraph number in 
the low order word and initialize the higher order word with 00H. 

4. Initializing with a string— DB only. 

In a DB you can define a string up to 255 characters long. Each character is 
stored in a byte, where successive characters occupy successive bytes. The 
string must be enclosed with single quotes. If you wish to include a single 
quote in a string, code it as two consecutive quotes. Examples are given 
below. 

ALPHABET DB ' ABCDE FGH I J KLMNOPQRSTUVWXYZ ' 

DIGITS DB '0123456789' 

WITHQUOTE DB 'THIS AIN"T HARD!!' [inserting quote 

; i n string 

In a DW and DD you may code a string of either one or two characters. In 
this case, the string is interpreted to be a number and it will be stored as a 
number. For example, 

NUMB DW 'AB' 

is equivalent to 

NUMB DW 4142H 

where the low byte is stored first followed by the high byte. The same con- 
vention is true for a DD. In that case, the upper 16 bits will be initialized to 
00H. 

5. Initializing with a repeated value. 

There is a special construct that can initialize an area of memory with a 
repeated value or list of values. The form for this construct is given below. 

repeatval DUP (val [,...] ) 

"Repeatval" is a positive number from 1 to 65535. It specifies the number 
of data initialization units to be initialized (bytes, words, dwords, qwords, 
or tbytes). "Val" may be any of the following: 

1. An expression— either numeric (appropriate to the data initialization 
unit) or an address-expression for a DW or DD. 

2. A "?" for indeterminate initialization. If the special form 



DB 


repeatval 


DUP 


(?) 


or 


DW 


repeatval 


DUP 


(?) 


or 


DD 


repeatval 


DUP 


(?) 


or 


DQ 


repeatval 


DUP 


(?) 


or 


DT 


repeatval 


DUP 


(?) 





is used, then no data initialization record will be produced in the object 
module, but the area will be reserved. Any other use of the "?" will 
cause a data initialization record to be produced, but the value used for 
initialization will be indeterminate. 

As an example: 

W0RD1 DB 2 DUP (?) 
W0RD2 DW 1 DUP (?) 

will both reference word variables without initializing data, whereas 
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W0RD3 DW ? 

W0RD4 DB 1 DUP (?,?) 

W0RD5 DB 1 DUP (?), 1 DUP (?) 

W0RD6 DB 2 DUP (1 DUP (?)) 

will all initialize words to an indeterminate value. 

3. A string where the data initialization unit is a DB. 

STRING DB 10 DUP ('HELLO') 

4. A list of the above items following the rules given above for each item. 

STRINGS DB 10 DUP (' HE LLO ',' GOODBYE ' ) 

ADDEXPS DW 3 DUP (COUNT, START, NEXT) 

NUMBS DD 100 DUP (1, OFFFFH, 15 10101010B) 

DIFFERENT DB 25 DUP (2, 'NSJRAJ', 3) 

5. "Val" may also be another DUP statement, following again all the 
above rules. DUP's may be nested up to eight levels deep. 

MORESTRINGS DB 15 DUP ('HELLO', 3 DUP ('GOODBYE')) 
MORENUMBS DW 27 DUP (1, 3, 5, DUP (2, 5, 7)) 
NESTEDDUP DB 3 DUP (4 DUP (5 DUP (1, 6 DUP" (0)))) 

Introduction to Records 

ASM86 has a special data initialization statement that allows you to construct bit- 
encoded data structures called records. A record may be either 8 or 16 bits in size. 
Each record is defined to have a number of fields containing a certain number of bits 
per field. You can store information in these fields and also access that information. 
Records are useful where you wish to access specific bits in a data structure. These 
could be flag bits, fields in a data structure used to store a real number, etc. There 
are special operators used to access the fields in a record. These are discussed in 
Chapter 4. There are two steps in using a record. The first defines a "template" for 
the record. This specifies the size of the record and its fields. The second step uses 
the record name in a data initialization statement to actually allocate the storage. 
These steps are described below. 

The RECORD Directive 
Record Template Definition 

Syntax: 

name RECORD field-name:exp [= initval] [,...] 

Description: 

A record is a bit pattern you define in order to format bytes or words for bit- 
packing. A record can be from 1 to 16 bits in size. Records are first defined through 
the Record Template Definition. Data can then be allocated and initialized through 
the use of the record name in a data initialization statement (given below). Some 
examples: 

ERRORFLAGS RECORD IOERR:3 = 0, SYSTEMERR :3 = , MEMERR :3 = 
S IGNEDNUMB RECORD SIGN:1, NUMBER:15 
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Field Values: 

name 

This is a unique ASM86 identifier, which is the name for the record template 
defined. 

field-name 

This is a unique ASM86 identifier, which defines a bit field within the record. 

exp 

This is a constant or expression that evaluates to be a number in the range 1 to 
16. This value specifies the number of bits in the field. (If a symbol is used in an 
expression, it must not be a forward reference.) The sum of the "exp's" in a 
record definition must not exceed 16; if they do, an error will be reported. 

[= initval] 

This is a constant or expression that evaluates to a number that can be 
represented by the number of bits defined for that field. This optional clause 
defines a default value for the field. If no initval is specified, the default value is 
zero. This default value can be overriden during allocation and initialization. 



"Partial" Records 

A "partial" record is a record that does not fully occupy a byte or word. The 
assembler will right-justify the fields within the record in the least significant bit- 
positions of the byte or word defined by the record. The undefined (unallocated) bits 
have a value of zero when the record is used to allocate storage. If you defined a 
record as below 

QUASI RECORD A:6, B:6 

it will be formatted as follows: 



15 12 11 6 5 

QUASI (definition, not storage) 



(undefined) 


(A) 


(B) 



4 bits 6 bits 6 bits 



Figure 3-1. "Partial" Record Definition 



Record Allocation and Initialization 

Syntax: 

[name] record-name < [exp] [,...]> 

or 

[name] record-name repeat-val DUP (< [exp] [,...]>) 
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Description: 

Use of this form will allocate data in the form specified by the record template used. 
You may override any default values given in the record definition. For example, 

FLAGS ERRORFLAGS <0,3,0> 

FLAGS1 ERRORFLAGS <> ;no initialization overrides 

PLUSONE SIGNEDNUMB <0,1> 

MINUS15 SIGNEDNUMB <1 , 15> 

Field Values: 

[name] 

A unique ASM86 identifier that is a name for the byte or word allocated. 

record-name 

This is the name of the previously defined record template that defines how the 
bits within the byte or word are to be allocated. 

[exp] 

You may optionally override default values of record fields when you allocate 
the storage. The "exp" must evaluate to a number that will fit in the number of 
bits in the field you wish to override. You may override all, some, or none of the 
fields in the record template. The following rules apply: 

For a record with N fields, each field is represented in the allocation statement, 
as shown below — 

<fl,f2,f3,...,fn> 

To override a particular field, place the value in the position of that field in the 
allocation statement. To override "f3" you would code 

<„2> 

To override "fn" you would code 

<„,...,2> 

Each "empty" override (the ",") specifies one field; you can skip fields up to 
the field you wish to override just by typing a "," for that field. You do not 
need to type anything for fields after the one you wish to override if you are not 
specifying any values for them. To allocate a record with no overrides you 
simply code: 

<> 

repeatval 

A positive integer that indicates the number of records to be allocated. 



Introduction to Structures 

You can define "structured" data blocks built from the basic types of data 
initialization statements. These data blocks are called "structures." A structure is 
composed of data initialization statements that define the fields within a block of 
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data. Each of the fields can be separately accessed. For example, if you wish to 
define a data structure that contains a complex number that has two fields, you 
could code the following: 

COMPLEX STRUC 

REALPART DQ 
COMPLEXPART DQ 

COMPLEX ENDS 

This code defines a template that can then be used to allocate storage. To store the 
complex number 1 .2 * 3.5i, you would code the following: 

VALUE COMPLEX <1 .2, 3.5> 

To perform any calculations based on this value, you would refer to the fields of the 
structure as 

VALUE. REALPART 

and 

VALUE. COMPLEXPART 

in the instruction (see Chapter 4). 



The STRUC Directive 

Structure Template Definition 

Syntax: 

name STRUC 



[fieldname] data-init 



name ENDS 



Description: 

A structure is a "structured" data type. This is similar to a "record" data type in 
Pascal, except that the type of elements you may define for a structure are restricted 
to the data types allowed in ASM86, (i.e., byte, word, dword, qword, and tbyte). A 
STRUC/ENDS pair defines a storage template with various subfields of possibly 
different types. This template can then be used to allocate data based on the "struc- 
ture" of the template. You may define values for the fields that can then be over- 
riden (with some exceptions) when the structure is used to initialize storage. An 
example of a structure is shown below. 



EMPLOYEE 

EMPNAME 

HOURRATE 

NUMBHOURS 

EMPLOYEE 



STRUC 

t)B ' 
DD 5 
DB ? 

ENDS 



60 



' ; 2 chars allowed 
; dollars per hour 
; hours per week to be used 
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This structure template could then be used to create data structures for different 
employees. You can override the initial values when the data is allocated and you 
may programmatically change the values in allocated structures (see Chapter 4). 

Field Values: 

name 

A unique ASM86 identifier that is the name for the structure template defined. 

fieldname 

A unique ASM86 identifier. This name will be used to access the fields within an 
allocated structure. It represents an offset from the base of the allocated struc- 
ture. In the example above, the field HOURRATE would have an offset of 20 
from the beginning of the structure. This value (expressed by the fieldname) is 
used in instructions to access the field. (See Chapter 4.) A fieldname has the 
following attributes: 

segment— none 

offset — number of bytes from start of structure 

type — type of init 

data-init 

This may be any allowed data initialization statement (DB, DW, DD, DQ, or 
DT). Refer to the section "Defining Variables" for the details on all the allowed 
forms. 



Structure Allocation and Initialization 

Syntax: 

[name] structure-name < [exp] [,...]> 

or 

[name] structure-name repeatval DUP (< [exp] [,...]>) 

Description: 

Use of this statement will allocate storage based on the structure template used. The 
amount of storage allocated will be a function of the number of bytes defined in the 
template. Initial values in the fields may be overriden with certain restrictions (see 
below). An array of structures can be allocated by using the form with a "DUP". 
For example, 

ACOMPLEXNUMB COMPLEX <1.6, 7.8> 

JONES EMPLOYEE < « JONES , SAM', 2.00, 60> 

PEOPLE EMPLOYEE 20 DUP (<>) 

Field Values: 

[name] 

A unique ASM86 identifier. This name will define a variable whose segment 
part will be the current segment and whose offset will be the current location 
counter. Its type will be an integer equal to the number of bytes allocated by the 
template. 
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structure-name 

A name of a previously defined structure template, 
repeatval 

A positive integer that indicates the number of structures to be allocated. 

exp 

This field is a value that will override the default value given in the template 
definition. Its type must match the type of the field. It may be either a constant, 
an expression, a string, or the indeterminate initialization character, "?". The 
value can only be used to override fields that meet the following restrictions: 

1. The field specified in the structure template definition cannot be a list of 
values or a DUP clause. 

2. A DB that is initialized with a single string of two or more characters can be 
overriden only with another string. If the overriding string is shorter than 
the original string, the remaining characters of the default string are used. If 
the overriding string is longer, it is truncated. 

3. The value must fit within the field you wish to override. 
Example of overridable fields — 

OVERRIDABLE STRUC 

A S T R I N G DB 'ABCDEFG' 
DONTCARE DW ? 
AREAL DD 3.14159 

OVERRIDABLE ENDS 

Example of non-overridable fields — 

NONOVERRIDE STRUC 

ALIST DB 1, 2, 3 
ADUP DW 10 DUP (?) 

NONOVERIDE ENDS 



For a structure with N fields, each field is represented in the allocation state- 
ment as shown below— 

<fl,f2,f3 fn> 

To override a particular field, place the value in the position of that field in the 
allocation statement. To override "f3" you would code 

<„2> 

To override "fn" you would code 

<„,...,2> 

Each "empty" override (",") specifies one field. You can skip fields up to the 
field you wish to override just by typing a "," for that field. You do not need to 
type anything for any fields after the one you wish to override if you are not 
specifying any values for them. To allocate a structure with no overrides you 
simply code: 

<> 
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© DEFINE a STRUCTURE template by enclosing a 
list of data-definition directives between 
STRUC/ENDS. Initial default values will be 
assigned to structure fields unless overridden dur- 
ing allocation. (Multiple fields, e.g., THIRD, can- 
not be overridden.) 



BLUEPRINT 


STRUC 


FIRST 


DW 


OFFFEH 


SECOND 


DW 


BUFFER 


THIRD 


DB 


7,5 


FOURTH 


DB 


'A' 


FIFTH 


DB 


? 


SIXTH 


DW 


257 


BLUEPRINT ENDS 






15 





F F E 


OFFSET(BUFFER) 


5 ! 7 


*INDET 


4 1 


10 1 



.FIRST 

.SECOND 

.THIRD 

.FOURTH 

.SIXTH 



(2) ALLOCATE storage for single or multiple copies 
using the structure-name from (T) as an 
assembly-time operator. The list in angle-brackets 
tells the assembler which default values to over- 
ride. Trailing fields' default to values in (T) . 



(B1 BLUEPRINT <>) 



£k 



F F E 


OFFSET (BUFFER) 


5 '• 7 


MNDET 


4 1 


10 1 



B1. FIRST 
B1. SECOND 
B1.THIRD 
B1. FOURTH 
B1. SIXTH 



(B2 BLUEPRINT <,0,„255>) 



O 






F 


F 


E 

















5 





7 


F 


F 


4 


1 





1 





1 



B2. FIRST 
B2. SECOND 
B2. THIRD 
B2. FOURTH 
B2. SIXTH 



C B3BLUEPRINT5DUP«,,,,50» ^ 



O 



OFFSET (BUFFER) 



OFFSET (BUFFER) 



B3.FIRSTI0] 

B3.SECOND[0] 

B3.THIRD[0j 

B3.FOURTH[0] 

B3.SIXTH[0] 

B3.FIRST[10i 

B3.SECOND[10] 

B3.SIXTH|30) 

B3.FIRST(40j 

B3.SECOND|40] 

B3.THIRD|40) 

B3.FOURTH[40] 

B3.SIXTHI401 



Q) REFERENCE structure fields as shown. Effective 
address of structure field is offset of structure 
copy plus relative displacement of field: 

MOV AL.B1. THIRD 

ADD AL.B2.THIRD + 1 ;for multiple field item 
ADD AL,B3.FIFTH[20] ;3rd copy in array, 
or[(N-1)*TYPEB3] 



'INDETERMINATE 



Or, load BX with offset B3, SI with multiple of 10 (since 
10 bytes in structure), and ripple through: 

MOV BX, OFFSET B3 

MOV SI, 30 ;in general, use (N-1)*TYPE B3 

ADD AL,[BX][SI]. FIFTH ;4th copy, 5th field 

Assuming B3 is addressed through DS. Otherwise, use 
segment override. 



Figure 3-2. Structure Definition and Allocation 
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Defining Labels 



A label, a symbolic name for a particular location in an instruction sequence, may 
be defined in one of three ways. The first way is the most common. The format is 
shown below: 

label: [instruction] 

where "label" is a unique ASM86 identifier and "instruction" is an 
8086/8087/8088 instruction. This label will have the following attributes: 

1 . Segment— the current segment being assembled. 

2. Offset — the current value of the location counter. 

3. Type— will be NEAR. 

An example of this form of label definition is: 

ALAB: MOV AX, COUNT 

The second means of defining a label is the PROC directive. This can be used to 
define either a near or far label. The third means is the LABEL directive. (Do not 
confuse the use of the term "label" with the name of this directive.) Either a near or 
far label can be defined. See below for a discussion of the PROC and LABEL 
directives. 



The PROC Directive 

Syntax: 

name PROC [type] 



name ENDP 



Description: 

A PROC directive is used to define a label and to delineate a sequence of instruc- 
tions that are usually interpreted to be a subroutine, that is, CALLed either from 
within the same physical segment (near) or from another physical segment (far). The 
primary use of the PROC directive is to give a type to the RET instruction enclosed 
by the PROC/ENDP pair. A PROC is different from a high-level language 
subroutine or procedure. There is no scoping of names in a PROC. All user-defined 
variables and labels in a program must be unique. Also, there is no "block- 
structuring" of PROC's. If a PROC is defined within a PROC, execution can "fall 
into" the PROC. For example 

P1 PROC NEAR 

MOV AX, 15 ; execution begun here will 

ADD DX, AX ;continue through to the MOV AX, 

P2 PROC NEAR 

MOV AX, 
CMP AX, COUNT 
JE LAB 
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SUB COUNT, 1 
LAB: MOV AX, 

RET ;exitP1andP2here! 

P2 ENDP 

CMP DX, 10 ; never will be executed!!! 

JE LAB 

RET 

P1 ENDP 

The 8086/8088 has two types of RET instructions, either near or far, that must cor- 
respond to the type of CALL made. Given below is an example of both a near and a 
far PROC, each with their appropriate CALL. 

Example 1— A NEAR PROC. 

L0CALC0DE SEGMENT PUBLIC 

ANEARPROC PROC NEAR 

;some code 

RET ;will be near RET 
ANEARPROC ENDP 



CALL ANEARPROC ;a near CALL 

L0CALC0DE ENDS 
Example 2— A FAR PROC. 
GL0BALC0DE SEGMENT WORD 

AFARPROC PROC FAR 

;some code 

RET ; w i L I be a far RET 
AFARPROC ENDP 

GL0BALC0DE ENDS 

SPECSEG SEGMENT BYTE 



CALL AFARPROC ;wi 11 be a far call 

; i nter segment 



SPECSEG ENDS 
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Field Values: 

name 

This is a unique ASM86 identifier that defines a label whose segment attribute is 
the current segment, and whose offset is the current location counter. Its type is 
defined in the PROC directive. 

type 

This field specifies the type for the label defined. The possible values are: 

1 . None specified — defaults to NEAR. 

2. NEAR — to define a near label. 

3. FAR— to define a far label. 

This field will specify to the assembler what type of CALL instruction to generate 
for the procedure and what type of RET instruction to code for any RET instruction 
found between the PROC/ENDP pair. 

The LABEL Directive 

Syntax: 

name LABEL type 

Description: 

The LABEL directive creates a name for the current location of assembly, whether 
data or code. You use the LABEL directive to define a variable or a label that will 
have the following attributes: 

1 . Segment — the current segment being assembled. 

2. Offset— the current offset within that segment. 

3. Type — the operand to the LABEL directive. 

The LABEL directive is useful for defining a different name with possibly a dif- 
ferent type for a location that is named through the usual means. For example, if 
you desire to access two consecutive bytes as both a word and as two different bytes, 
the following usage of the LABEL directive will allow both forms of access. 

AWORD LABEL WORD 
LOWBYTE DB 
HIGHBYTE DB 

It can also be used to define two labels of different types for the same location of 
code. This is useful if a section of code is to be called both near and far. (The pro- 
grammer must be careful in this case to insure that the right RET is executed for the 
type of CALL made.) The following (potentially deadly) example illustrates this use. 

AFARLABEL LABEL FAR 
NEARLAB: MOV AX, BX 

Field Values: 

name 

A unique ASM86 identifier. 
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type 

This field identifies the type that is to be assigned to this name and location. It 
can specify a variable or a label depending on the type. This field can have the 
following values: 

1 . BYTE— defines a variable of type byte. 

2. WORD — defines a variable of type word. 

3. DWORD— defines a variable of type dword. 

4. QWORD— defines a variable of type qword. 

5 . TBYTE— defines a variable of type tbyte. 

6. A structure name— the type will be equal to the number of bytes allocated 
by the structure. 

7. A record name— the type will either be a byte or word depending on the size 
of the record. 

8. NEAR— defines a label of type near. 

9. FAR— defines a label of type far. 

The Location Counter ($) 

The location counter keeps track of the current offset within the current segment 
that is being assembled. This value is symbolized by the character "$", which may 
be used in certain contexts, (i.e., expressions or instructions) (see Chapter 4). This 
symbol represents a near label, whose attributes are: 

segment — current segment 
of fset— current offset 
type— near 

The assembler will maintain the correct offset within a segment even if the segment 
is repeatedly "opened" and "closed" in the module with the appropriate 
SEGMENT/ENDS pairs. 

The ORG Directive 

Syntax: 

ORG exp 

Description: 

The ORG directive allows you to control the location counter within the current seg- 
ment. You use the ORG directive to set the location counter to the desired value. Be 
careful in the use of this directive not to overwrite any previously allocated data or 
code by ORGing to a location previously allocated. The ORG directive is used to 
locate code or data at a particular location (offset) within a segment. Used with an 
absolute segment, you can specify the actual location in memory in which the code 
or data will be located. 

Field Values: 
exp 

This is an expression that is evaluated modulo 65536. The expression must not 
include any forward references. You may use the value of the current location 
counter, "$" in an expression, such as: 

ORG OFFSET ($+1000) 
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Avoid expressions of the form 

ORG OFFSET ($-1000) 

since this will overwrite your last 1000 bytes of assembly (or will re-ORG high in 
the current segment if the expression evaluates to a negative number). 

The EVEN Directive 

Syntax: 

EVEN 

Description: 

The EVEN directive ensures that the code or data following the use of the directive 
will be aligned on a word boundary. For 8086 data, this may result in a faster fetch- 
time. The assembler will insert a NOP (90H) in front of the code or data, if it is 
necessary, to force the word alignment. The EVEN directive cannot be used in a byte 
aligned segment — an error message will be issued. 

The PURGE Directive 

Syntax: 

PURGE name [, ...] 

Description: 

The PURGE directive deletes the definition of a specified symbol, allowing the sym- 
bol to be redefined. All occurrances of the symbol following the PURGE directive 
and the redefinition of the symbol will use the new definition. It will remain unde- 
fined after it is purged unless it is redefined. A reference to a symbol after a purge, 
but before a redefinition is a forward reference to the redefinition. If no redefinition 
occurs, the reference will cause an error. The following types of symbols cannot be 
purged— 

1. Register names 

2. The symbol ??SEG. 

3. Hands-off keywords (see list in Appendix C). 

4. A symbol that appears in a PUBLIC statement. 

Using the PURGE Directive to Control Debug Information 

The PURGE directive can be used to control the symbol information placed in the 
object module by the assembler when the DEBUG control is specified. (See the 
Operating Instructions for a description of the DEBUG control. If you do not wish 
to have information placed, in the object module for certain symbols, you can purge 
those symbols at the end of the program just before the END statement. 
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CHAPTER 4 
ACCESSING DATA-OPERANDS 

AND EXPRESSIONS 



8086/8087/8088 Instruction Statements 

Syntax: 

[label:] [prefix] mnemonic [operand [, operand]] 

Description: 

The instruction statements form the core of an assembly language program. These 
statements define the actual program that the CPU (and NDP) will execute. This 
chapter describes the operands used in the assembly language. The 8086/8087/8088 
instruction set is defined and discussed in Chapter 6. The operand field specifies the 
object of the machine operation. For a two operand instruction, one of the operands 
is considered a destination operand and the other is the source operand. This form is 
given below. 

INSTRUCTION DESTINATION, SOURCE 

Some examples, shown below, illustrate some instruction statements: 

MOV AX, ;pLace into AX 

ADD CL, DL ;CL = CL + DL 

ALAB: REP MOVSB ; w i t h prefix instruction and Label 

Refer to Chapter 6 for the use of the Prefix instructions. 

Field Values: 

[label:] 

A unique ASM86 identifier, followed by a colon, that is used to define a label. 
(See Chapter 3.) 

[prefix] 

An 8086/8088 Prefix instruction, i.e., LOCK and REP instructions. (See 
Chapter 6.) 

mnemonic 

An 8086/8088 or 8087 instruction. These are fully described in Chapter 6. 

operand 

There are many possible types of operands, including registers, constant values, 
variables, and labels. The operand you specify will depend on the instruction 
coded. All of the various operand types are discussed below. 
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Operand Types 
Registers 

The 8086/8088 registers can be used as explicit operands to many instructions. In 
two-operand instructions they may be used for both source and destination. The 
register set is shown below. 



Segment Registers: 
CS,DS,SS,ES 

General Registers (16 Bits): 

AX, BX, CX, DX, SP, BP, SI, DI 

General Registers (8 Bit): 

AL, AH, BL, BH, CL, CH, DL, DH 

Pointer and Index Registers: 
BX,BP,SI,DI 

The different sets overlap. Each of the general registers (8 and 16 bit) can participate 
in arithmetic and logical operations. The Pointer and Index registers are also used in 
certain address modes (see Register Expression section below). The segment registers 
can be used in MOV's, PUSH'S, and POP's. 

Floating Point Stack 

The 8087 has it's own set of 'registers' called the floating-point stack. There are 
eight stack elements that can be referenced. The form is ST(i), where 'i' refers to the 
element through 7. The top-of-stack is always ST(0), which may be abbreviated as 
ST. 



Immediate Operands 

An immediate operand is a constant value (number). This is a "17-bit" number (see 
Chapter 3). Immediate operands are used as source operands in an 8086/8088 
instruction statement. For example, 

MOV AL, 5 ; A L = 5 

CMP AX, OFFFFH ;compare AX to OFFFFH 

An immediate operand can also be an expression that evaluates to a number. This 
chapter discusses all the types of expressions. 

Examples of expressions as immediate operands: 

CMP AL, 15 OR 5 ; an express ion ex amp Le-- compare 

;AL with 15 

ADD DX, (23 * 2) / 10 ;add 4 to DX 
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Memory Operands 

A memory operand refers to a particular location in memory. The general term for a 
memory operand is an "address expression." An address expression may be a sim- 
ple variable or label name, or it may involve registers, structure fields, and/or con- 
stants. Each address expression will reflect a particular addressing mode. The 
8086/8088 has many different types of addressing modes. They are: 



Direct Address 

The operand is a simple variable or label name. The name expresses the offset of the 
operand that is used to calculate the address. 



MOV AX, COUNT 
JMP ALAB 



;move the word value at memory Location 
;C0UNT into AX 

; j ump to memory Location ALAB 



Register Indirect Address 

In this case the offset of the memory location is contained in one of the pointer or 
index registers (BX, BP or SI, DI). To address the location you must first load the 
offset into the register and then use the register name in brackets as the operand. For 
example, to indirectly address a variable you would code the following: 

MOV BX, OFFSET AVAR 

MOV AX, [BX] ;AX = contents of AVAR 

A JMP or CALL instruction can use any 16-bit general register for indirect 
addressing. 



MOV AX, OFFSET ALAB 
JMP AX 



MOV TARG, OFFSET ALAB 
MOV BX, OFFSET TARG 
CALL [BX] 



;no [] are needed here!--simpLe 
; i ndi rect j ump to ALAB 



;[] used here (a register 

; expression) ! - - 1 w o LeveL indirect 

; j ump to ALAB 

The two levels of indirection in JMP/CALL [BX] are schematically depicted as 
follows: 



JMP/CALL [BX1 



OFFSET ADTARG 



ADTARG (DWORD) 




OFFSET TARGET 
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Based Address 

The base address mode is similar to register indirect mode except that, in this case, a 
displacement is added to the contents of the register. With this mode the register can 
point to the base of a data structure in memory and the displacement can then be 
used to access a field within the data structure. 

MOV BX, OFFSET DATASTRUC ;BX = base of DATASTRUC 
MOV AX, [BX + 5] ;AX = word Located at the 

;fifth byte of DATASTRUC 

Based addressing is typically used with either BX or BP as the base register though 
SI and DI may also be used. The displacement may be either 8 or 16 bits. 

Indexed Address 

Indexed addressing is similar to based addressing except that the registers SI or DI 
are used along with a variable name. These registers are used as an index from the 
offset represented by the variable name. The contents of the register used as an index 
specifies a byte displacement from the offset of the variable. You may also use a 
displacement value in the operand. 

MOV SI, ;set indices to 

MOV DI, 

MOV CX, LENGTH SOURCE 

ALAB: MOV AX, SOURCE [SI] ;indexed address 

MOV DESTtDI], AX 

INC SI 

INC SI ;indexnextwordinSOURCE 

INC DI 

INC DI ;index next word in DEST 

LOOP ALAB 

Based Indexed Address 

This mode uses the contents of a base register (BX, BP), the contents of an index 
register (SI, DI), and an optional displacement. With this mode you may point the 
base register at the base of a data structure and then use the index register as an 
index into that structure. 

MOV BX, OFFSET ARRAYSTRUC ; load base address 
MOV SI, ;index value 

ALAB: MOV AX, [BX + SI] ;get element 



ADD SI, 2 ; increment index 

JMP ALAB 

Segment Register Defaults 

Variable references such as: 

[BX] 

[BP] 

WORD PTR [DI] 

[BX] .FIELDNAME 

BYTE PTR [BP] 
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are termed "anonymous references" because no variable name is given from which 
a segment can be determined. (The structure field in the fourth example has a type 
and offset, but no segment associated with it.) 



Segment registers for anonymous references are determined by hardware defaults, 
unless you explicitly code a segment prefix operator. The hardware defaults are: 

• [BX] normally defaults to segment register DS 

• [BP] normally defaults to segment register SS 

• When an index register is used without a base register (as in WORD PTR [DI] or 
[SI + 5]), the default segment register is DS 

• When an index register is used with a base register (as in [BP][SI] or BYTE PTR 
[BX][DI]), the default segment register is that of the base register (SS or DS, in 
these cases). 



There are two variable-referencing exceptions for defaults: 

1. Operations which implicitly reference the stack (PUSH, POP, CALL, RET, 
INT, and IRET) always use SS, and cannot be overridden. (The construct [SP] 
is not an addressing mode, and thus you cannot assemble e.g. MOV [SP], BX, 
much less override it.) 

2. String instructions always use ES as a segment register for operands pointed to 
byDI. 



Special care must be taken to ensure that the correct segment is addressed when an 
anonymous offset is specified. Unless you code a segment prefix override, the hard- 
ware default segment will be addressed, and the anonymous offset applied to it. 



Thus, if a programmer's declared variables all reside in segment SEG1 : 
SEG1 SEGMENT 



F00 DW 500 DUP (0) 



500 words of 0's 



SEG1 ENDS 

and if his ASSUME directive in segment CODE1 is as follows: 

ASSUME CS : C0DE1 , DS : SEG1 



then all references to named variables in segment SEG1 will assemble correctly. But 
suppose our programmer elects to use BP as an index register to access elements of 
FOO in SEG1, as follows: 



MOV BP, OFFSET FOO 
MOV AX, [BX] 



Load BP with offset of FOO in 
SEG1 . 

Put first word of FOO into AX. 
No assembly-time error, but wrong 
seg-reg (SS instead of DS) at 
run-t ime . 
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Because no variable name is present (for ASSUME to check), and because no seg- 
ment override prefix is specified, the [BP] reference, by default, specifies an offset 
address that will be combined with the SS segment register, and not the DS, as 
intended. The code should read: 



MOV BP, OFFSET F00 
MOV AX, DS: [BP] 



Load BP with offset of F00 in 
SEG1 . 

Use DS seg-reg for DATA1 , put 
f i rst word of F00 into AX . 



Overview of Expressions 



An expression can define a value that initializes data or is used as an operand to an 
instruction. An expression can specify a numeric value or define an address in 
memory that will then serve as an instruction operand. There are many different 
kinds of operators that you may use to create expressions: 

• Arithmetic Operators 

high and low (HIGH, LOW) 
addition and subtraction (+, -) 
multiplication and division (*, /, MOD) 
shifting operators (SHR, SHL) 

• Logical Operators (AND, OR, XOR, NOT) 

• Relational Operators (EQ, LE, LT, GE, GT, NE) 

• Attribute operators 

attribute overriding operators (segment override, PTR, SHORT, THIS) 
attribute value operators (SEG, OFFSET, TYPE, LENGTH, SIZE) 

• Record-Specific Operators (shift count, MASK, WIDTH) 

These operators can be used to define numbers or with the attribute operators you 
may define variables or labels. Each type of operator is discussed below. 



Types of Expression Operands 



Numbers 

A number or constant (17-bit number) can be used in most expressions. There are 
some limitations in the use of relocatable numbers (these are numbers whose values 
are unknown during assembly). These limitations and the definition for relocatable 
numbers are discussed below. The attribute value operators (e.g., OFFSET) return 
numbers that can be relocatable. Simple numbers or constants (such as "2") can be 
used without any limitations for most operators and expression types. An absolute 
number is a value known at assembly time. 
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Address Expressions 

An address expression defines a location in memory. This location can be viewed as 
either a variable or label, depending on the type of expression used. The simplest 
address expression is the name of a variable or label. In this case, the name implies 
addressing using the offset of the variable or label. 

ADD DX, COUNT ; COUNT is simple address expression 

ADD DX, COUNT + 2 ; I n this case, the address 

; expression has the same segment 
;and type as COUNT but has an 
; offset that is two greater 

ADD DX, COUNT C23 ;is equivalent to COUNT + 2 

A register expression is an address expression that uses a pointer and/or index 
register. This form was shown above under the discussion of addressing modes. The 
different types of register expressions are shown below: 

1. [pointerreg] or [indexreg] 

[BX] [SI] 

[BP] [DI] 

2. [pointerreg + indexreg] 

[BX + SI] 

[BX + DI] 

[BP + SI] 

[BP + DI] 

3. [pointerreg + disp] or [indexreg + disp] 

[BX + disp] [SI + disp] 

[BP + di sp] [DI + di sp] 

4. [pointerreg + indexreg + disp] 

[BX + SI + disp] 

[BX + DI + disp] 

[BP + SI + disp] 

[BP + DI + di sp] 

NOTE 
Disp can be either an 8 or 16 bit displacement. 

NOTE 

You may also substitute a set of "[ ]" for the "+" in these types of 
expressions. For example, the following are equivalent forms: 

[BX + SI] is the same as [BX] [SI] 

[ B P + D I + 2 ] is the same as [ B X ] [ D I ] [ 2 ] 

A register expression can be combined with a simple address expression to form a 
more complex address. This allows for indexed variables or doubly-indexed 
variables. The form is: 

name [reg exp] 
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Examples: 

COUNT [BX] ;simple index 

COUNT [ BX + 2] ; index plus displacement 

COUNTCBX + SI] jdouble index 

A register expression implies that the address of the operand will be computed using 
the run-time contents of the registers used. For the examples above, the offset of the 
variable COUNT will be added to the contents of the register(s) in the register 
expression. 

You may use a register expression by itself as an operand. This case is called an 
anonymous reference because the reference has no explicit type (either byte, word, 
etc.). When using this form you must insure that a type is specified. For a two 
operand instruction where one of the operands is a register, the assembler will deter- 
mine the type from the type of the register. For example: 

MOV CX, [BX] ;move word pointed to by BX 

In all other cases using an anonymous reference, you must specify the type using the 
PTR operator (discussed below). For example: 

MOV WORD PTR [DI], 5 ;assign two bytes 
INC BYTE PTR [BX + 2] increment a byte 



Accessing Structure Fields 

Another form of address expression uses a structure field name as a displacement 
that is added to an offset. A field name represents an offset within the structure (see 
Chapter 3). For example, 

ASTRUC STRUCTURE 

ABYTE DB joffset = 
AWORD DW ;offset = 1 
BYTE2 DB ;offset = 3 

ASTRUC ENDS 

The field names can then be combined with a variable name or register expression to 
form an address expression. This address expression has the following attributes: 

segment— same as variable or machine default for register expression 

offset — offset of variable or register expression plus the offset of the field within 
the structure. 

type — type of structure field. 
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For example, 

ANARRAY DB 1,2,3,4, 

MOV AL, ANARRAY. BYTE2 ;AL will equal 4 

MOV CX, ANARRAY. AWORD ;CX will equal 0302H 

MOV BX, OFFSET ANARRAY ;BX holds offset 

MOV AL, [BX].ABYTE ;AL will equal 1 

Relocatable Expressions 

Address expressions (those involving variables and labels) and numeric expressions 
may have results which cannot be known until logical segments have been combined 
and located. These expressions are termed "relocatable." The following rules define 
when an expression is relocatable. There are some restrictions on the use of 
relocatable expressions with some of the operators. These restrictions are noted 
below for each operator. 

1 . Segments and Groups — the name of a segment or group can be used to represent 
its paragraph number in an expression. This value is relocatable for all segments 
and groups except for a segment defined with the "AT exp" form of the SEG- 
MENT directive. These values are assigned by the locator or loader. This type of 
relocatability is called "Base relocatability." 

Example: 

DATAGRP GROUP DATA1 , DATA2 

DATA1 SEGMENT PUBLIC 



DATA1 ENDS 

DATA2 SEGMENT PUBLIC 

SEGSTORE DW DATAGRP ; D A T A G R P is base relocatable 

SEGBASE DW DATA1 ; D A T A 1 is base relocatable 

DATA2 ENDS 

2. Variables and Labels — a variable or label is not considered to be relocatable if it 
is defined in a "non-relocatable segment." This is a segment that has either a 
PARA or PAGE alignment type and is not a PUBLIC or STACK segment, or it 
was defined with the "AT exp" combine-type. Use of a variable name in an 
expression implies the value of its offset within its segment. This value will be 
relocatable for any variable or label that is defined in a "relocatable" segment 
or in an EXTRN directive. A relocatable variable or label is "offset 
relocatable." These values are assigned by the linker. 

Example: 

DATA SEGMENT PUBLIC 

ABYTE DB 

AWORD DW ABYTE ;ABYTE is offset relocatable 

DATA ENDS 
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Numbers — a constant is relocatable if it is defined in an EXTRN directive with 
type ABS. In this case the term "relocatable" indicates that the value of the 
number, defined in another module, is unknown at assembly time. 

Example: 

EXTRN ANUMBER:ABS 

DATA SEGMENT 

AWORD DW ANUMBER ;ANUMBER is relocatable 

DATA ENDS 



Arithmetic Operators 

HIGH/LOW 

Syntax: 

HIGH operand 
LOW operand 



Description: 

These operators are called the "byte isolation" operators. HIGH and LOW accept 
either a numeric expression or a variable or label as an operand. HIGH returns the 
high-order byte; LOW the low-order byte. If the operand is an absolute number then 
the result will be absolute. In all other cases, the result will be relocatable. An error 
will result if these operators are used with an operand or expression involving a seg- 
ment or group name. For example, 

MOV AH, HIGH (1234H) ;AH = 12H 
TENHEX EQU LOW (0FF10H) ;TENHEX = 10H 

These operators can be applied to each other; if Q is a relocatable value, the follow- 
ing identities apply: 

LOW LOW Q = LOW Q 

LOW HIGH Q = HIGH Q 

HIGH LOW Q = 

HIGH HIGH Q = 



Field Values: 

operand 

A numeric expression or a variable or label name. 
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Multiplication and Division 

Syntax: 

Multiplication: operand * operand 

Division: operand / operand 

Modulo: operand MOD operand 

Description: 

You may only use these operators with absolute numbers, and the result is always an 
absolute number. Either operand may be a numeric expression, as long as the 
expression evaluates to an absolute number. Some examples, 

CMP AL, 2*4 ; compare AL to 8 
MOV CX, 123H/16 ;CX = 12H 

Field Values: 

operand 

An absolute number. 



Shift Operators 

Syntax: 

Shift right: operand SHR count 
Shift left: operand SHL count 



Description: 

The shift operators will perform a "bit-wise" shift of the operand. The operand will 
be shifted "count" bits either to the right or the left. Bits shifted into the operand 
will be set to 0. The operands must be numeric expressions that evaluate to absolute 
numbers. For example, 

MOD BX, OFACBH SHR 4 ;BX = BX + OFACH 



Field Values: 

operand 

A numeric expression that evaluates to an absolute number. 

count 

An absolute number that represents the number of bits the operand is to be 
shifted, either right or left. 
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Addition and Subtraction 

Syntax: 

Addition: operand + operand 

Subtraction: operand - operand 

Description: 

These operators can be used with either absolute or relocatable operands, but there 
are certain restrictions in the use of relocatable operands. The following shows all 
the allowed uses of absolute and relocatable operands. 

ABS = an absolute operand 

RELOC = a relocatable operand 

ABS + ABS ABS - ABS 

ABS + RELOC RELOC - ABS 

RELOC + ABS RELOC - RELOC 

NOTE 

"reloc — reloc" is only allowed for operands with the same type of 
relocatability and the quantities are defined in the same segment (both are 
either base or offset relocatable). The result of "reloc-reloc" is an absolute 
number. 

Field Values: 

operand 

An expression evaluating to an absolute number or a variable or label name. 

Relational Operators 

Syntax: 

equal: operand EQ operand 

not equal: operand NE operand 

less than: operand LT operand 

less than or equal: operand LE operand 

greater than: operand GT operand 

greater than or equal: operand GE operand 



4-12 



ASM86 Accessing Data — Operands and Expressions 

Description: 

The relational operators may have operands that are: 

a. both absolute numbers 

b. variable or label names (defined in the current module), that have the same type 
of relocatability. 

The result of a relational operation is always an absolute number. They return an 
8-or 16-bit result of all 1 's for TRUE and all O's for FALSE. Some examples, 

MOV AL, 3 EQ ;AL = (false) 

CMP BX # 2 LE 15 ;BX = OFFFFH (true) 

Field Values: 

operand 

An absolute number or a variable or label name. 



Logical Operators 

Syntax: 

operand OR operand 

operand XOR operand 
operand AND operand 
NOT operand 

Description: 

The logical operators may only be used with absolute numbers. They always return 
an absolute number. 

A logical operator can be either: 

1 . OR — logical "or", maps O's in corresponding positions into and 1 's elsewhere 
in the result, for example, 

11011001B OR 10011011B = 11011011B 

2. XOR — exclusive "or", maps corresponding bits equal in value into 0, and 
corresponding bits unequal in value into 1, for example, 

10111011B XOR 11011101B = 01100110B 

3. AND— logical "and", maps l's in corresponding positions into 1 and O's 
elsewhere in the result, for example, 

101 1001 IB AND 1101101B = 1000000 IB 

4. NOT— logical negation, forms the 1 's complement by mapping l's to O's and O's 
to l's, for example, 

NOT(lOlOllllB) = 01010000B 



4-13 



Accessing Data — Operands and Expressions ASM86 

Field Values: 

operand 

An absolute number. 

Attribute Overriding Operators 
Segment Override 

Syntax: 

CS:varlab 

DS:varlab 

SS:varlab 

ES:varlab 

segname:varlab 

groupname:varlab 

Description: 

The segment override is used to override the segment attribute of a variable or label. 
There are two uses for this override, the first is similar to an ASSUME, and the 
second is used in order to store the correct offset of a variable or label. 

The first form uses a segment register as the "segpart" of a memory address. In this 
case you are specifying from which segment register the variable or label is address- 
able. This form is similar to an ASSUME, except that it is restricted to a single state- 
ment. It is also more error prone than the use of an ASSUME because you must 
explicitly code the override for each reference to a variable or label. The explicit use 
of a segment override takes precedence over any ASSUME directive. The following 
example illustrates the use. 

ASSUME DS-.DATA, C S : C D E 

DATA SEGMENT 

ABYTE DB 

DATA ENDS 

CODE SEGMENT 

MOV BL, ABYTE ; reference is covered by the 

; ASSUMfE 

MOV BL, ES-.ABYTE ;no ASSUME is required here for 

; t h i s reference 

CODE ENDS 
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Another use of this form is to override the implicit use of a segment register in 
accessing data. The 8086/8088 will use the DS register in order to access data. When 
the following line of code is executed, the DS register is used. 

MOV BL, [BX] 

You may use the segment override to change this implicit use. If, for example, your 
data is addressable through the ES register and you do not have an ASSUME, you 
can code the following form: 

MOV BL, ES : [BX] 

The instruction that is assembled will be preceded by a "segment override prefix" 
byte that forces the 8086/8088 to use the ES register in order to calculate the physical 
address of the variable. The same effect will occur if you ASSUME your data into 
ES. 

The second use of the segment override is to insure that your use of the OFFSET 
operator (see below) will return the correct offset of your variable or label. When a 
variable or label is defined in a segment that is part of a group, then you must use the 
segment override with the group name when you use the OFFSET operator (see the 
discussion of the OFFSET operator given below). This is to ensure that the offset 
from the group base, rather than the segment base, is returned. 

Field Values: 

varlab 

A variable name, label name, or address-expression, 
segname 

A segment name, 
groupname 

A group name. 



PTR Operator 

Syntax: 

type PTR name 

Description: 

The PTR operator is used to define a memory reference with a certain type. The 
assembler determines the correct instruction to assemble based on the type of the 
operands to the instruction. There are certain instances where you may specify an 
operand that has no type. These cases involve the use of numeric or register expres- 
sions. Here the PTR operator is used to specify the type of the operand. The follow- 
ing examples illustrate this use: 

MOV WORD PTR [BX], 5 ;set word pointed to by BX = 5 

INC DS : BYTE PTR 10 ;inc:rement byte at offset 10 

; f r om D S 
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This form can also be used to override the type attribute of a variable or label. If, for 
example, you wished to access an already defined word variable as two bytes, you 
could code the following: 

MOV CL, BYTE PTR AWORD ;get first byte 

MOV DL, BYTE PTR AWORD + 1 ;get second byte 

Field Values: 

type 

This field can have one of the following values: 

1. BYTE 

2. WORD 

3. DWORD 

4. QWORD 

5. TBYTE 

6. NEAR 

7. FAR 



name 



This field can be: 

1. A variable name. 

2. A label name. 

3. An address or register expression. 

4. An integer that represents an offset. 



SHORT Operator 

Syntax: 

SHORT label 

Description: 

The SHORT operator is used to specify that the label referenced by a JMP instruc- 
tion is within +127 bytes at the instruction. This operator is only used when the label 
is forward referenced in the instruction. When the assembler encounters a forward 
reference, it must make certain assumptions. When a label is forward referenced, 
the assembler assumes that it will require two bytes to represent the relative offset of 
the label. By correctly using the SHORT operator, you can save a byte of code when 
you use a forward reference. If the label is not within the specified range, an error 
will occur. The following example illustrates the use of the SHORT operator. 

JMP FWDLAB ; three byte instruction 

JMP SHORT FWDLAB ;two byte instruction 
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Field Values: 

label 

A label addressable through CS. 

Attribute Value Operators 

The operators discussed below return the numerical values of the attributes of a 
variable or label. These operators do not change the attribute of the variable or label 
used. 



THIS Operator 

Syntax: 

THIS type 

Description: 

The THIS operator defines a memory location at the current location of assembly. 
This location can be either a variable or a label. Its segment attribute will be the cur- 
rent segment being assembled and its offset will be the value of the current location 
counter. Its type will be specified by the operand to this operator. Use of this 
operator is similar to the use of the LABEL directive. This operator is used either in 
conjunction with the EQU directive (see below) or as part of an operand to an 
instruction. (The latter form will be rarely used.) It can be used to define another 
name with an alternate type for a data item; for example 

AWORD EQU THIS WORD 
BYTE1 DB 
BYTE2 DB 

is equivalent to: 

AWORD LABEL WORD 
BYTE1 DB 
BYTE2 DB 

Use of the symbol "$" (the location counter symbol) is equivalent to THIS NEAR. 

Field Values: 

type 

This field can have the following values: 

1 . BYTE 

2. WORD 

3. DWORD 

4. QWORD 

5. TBYTE 

6. NEAR 

7. FAR 
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SEG Operator 

Syntax: 

SEG varlab 

Description: 

This operator returns the segment value of the variable or label, a base relocatable 
quantity. Use of this operator can have two interpretations, depending on the con- 
text used. In an ASSUME directive, you may use this operator to specify the seg- 
ment in which an object is defined. For example, 

ASSUME CS : SEG START, DS : SEG COUNT 

specifies that CS will hold the paragraph number of the segment containing "start" 
and that DS will hold the paragraph number of the segment in which "count" was 
defined. This construct is useful with objects for which you do not know the seg- 
ment in which they are defined (most likely defined in another module). In this case 
the expression is a symbolic representation of the segment's name. 

The other type of interpretation is that of a paragraph number. Here it is used either 
to store the paragraph number in a variable or to initialize a segment register. 

SETSTART DW SEG COUNT ;store the paragraph number 

;for the segment 

IN IT : MOV AX, SEG COUNT 

MOV DS, AX ; i n i t DS with count's 

; segment 

The SEG operator should be avoided when groups are used. Variables and labels are 
relative to the base of the group and not to the segment in which they are defined. 
The value returned by the SEG operator for an element that is contained within a 
group will not reflect the group base. 

Field Values: 

varlab 

The name of a variable or label. 



OFFSET Operator 

Syntax: 

OFFSET varlab 

Description: 

This operator returns the offset of the variable or label from the base of the segment 
in which it is defined. In most cases, the value returned is not set until link time, i.e., 
it is a relocatable number. The OFFSET operator is used primarily to initialize 
variables or registers to be used for indirect addressing. Some instructions explicitly 
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use indirect addressing when accessing data. When coding these instructions, you 
are required to initialize a register to the offset value of the data you wish to access. 
The following example demonstrates this use — 

TRANSLATE: MOV BX, OFFSET ASCIITABLE 
MOV AL, VALUE 

XLAT ;BX points to translation 

; t a b I e 

If a variable or label is contained in a group (its segment is defined to be in a group), 
then you must use a group override with the OFFSET operator. This ensures that the 
offset used is from the group base and not from the individual segment base. For 
example, 

D6R0UP DATA1, DATA2 

DATA1 SEGMENT PUBLIC 



DATA1 ENDS 

DATA2 SEGMENT PUBLIC 

ASCIITABLE DB 
DB 1 

DB 128 

DATA2 ENDS 

CODE SEGMENT PUBLIC 

TRANSLATE: MOV BX, OFFSET DG ROUP : AS C I ITAB LE ;need group 

/override 
; h e r e 
MOVE AL, VALUE 
XLAT ;BX points to 

; translation table 

CODE ENDS 



Field Values: 

varlab 

The name of a variable or label. 



TYPE Operator 

Syntax: 

TYPE varlab 
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Description: 

The TYPE operator returns a value that represents the type of the operand. This 
value can be useful in certain instruction sequences where the type of the operand is 
used to calculate a value used in incrementing a pointer. For example, 



MOV BX, OFFSET ARRAY 

MOV CX, LENGTH ARRAY 

MOV SI, 

ALAB: ADD AX, [BX + SI] 



LENGTH = # of elements 

used as i ndex i nto array 

array element added to 
AX 



ADD SI, TYPE ARRAY ; increment the pointer by 
LOOPALAB ;the size of an array 

; e lement 

TYPE returns the following values, depending on the type of the operand — 

1. A byte — returns 1. 

2. A word— returns 2. 

3. A dword — returns 4. 

4. A qword — returns 8. 

5. A tbyte — returns 10. 

6. A structure name — returns a value equal to the number of bytes declared in the 
structure definition. 

7. A near label — returns 255. 

8. A far label — returns 254. 

Field Values: 

varlab 

The name of a variable, structure, or label. 



LENGTH Operator 

Syntax: 

LENGTH variable 

Description: 

LENGTH returns the number of data units (bytes, words, or dwords) that have been 
allocated for a variable. The data unit is equal to the type of the variable. This 
operator is useful for setting a counter for a loop that accesses the elements of an 
array (see example above). 

AWORDARRAY DW 150 DUP (0) ;LENGTH = 150 

ABYTEARRAY DB 1,2,3,4,5,6,7 ;LENGTH = 7 
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Field Values: 

variable 

The name of a variable. 



SIZE Operator 

Syntax: 

SIZE variable 



Description: 

The SIZE operator returns the number of bytes allocated for a variable. This value is 
related to the LENGTH and TYPE operators through the following identity: 

SIZE = LENGTH * TYPE 

Some examples, 

AWORDARRAY 

ABYTEARRAY 



ASIZE 



DW 150 DUP (0) 

DB 1,2,3,4,5,6,7 

MOV AX, SIZE AWORDARRAY 

DB SIZE ABYTEARRAY 



; S I Z E = 300 

;SIZE = 7 

;AX = 300 

; ASIZE is initialized 
;to 7 



Field Values: 

variable 

The name of a variable. 



Record Specific Operators 

Use of records may involve three special operators. These operators allow you to 
isolate and access the fields defined within a record. Since the fields in a record are 
mapped into bits and not into byte-aligned structures, you may require that these 
fields be masked off (in order to isolate only specific bits) and then shifted into the 
lower order bits of a byte. (The record-specific operators are described individually 
below.) 

A record name can also be used in an expression. In this case the record is used to 
specify a number based on the initialization used. For example, if you define the 
record 

R RECORD F1:8, F2:8 

you could use it to define a numeric expression that will evaluate to a constant 
number. 
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MOV AX, R<0ABH, 'C»> ;AX = 0AB43H 

MOV BX, R<5,7> + R<3,4> ;BX = 080BH 

MOV CX, R<86H, 23H> XOR R<135, 35> ;CX = 100H 



Shift Count 

Syntax: 

recfieldname 



Description: 

Use of the record field name specifies the number of bits the record must be shifted 
in order to move the field in it to the low order bits of a byte or word (depending on 
the size of the record). For example, if you had defined the following record: 

PATTERN RECORD A:3, B:1, C:2, D:4, E:6 

AREC PATTERN < > 

you could use the following sequence of code to isolate and access the field C in the 
record: 



MOV DX # AREC 
AND DX, MASK C 



MOV CL, C 
SHR DX, CL 



move record into DX 

mask out fields A,B,C,D,E-- 

000011000000000013 is the 

value used 

field name as shift count--10 

is the value used 

DX is now equal to value of 

field C 



Field Values: 

recfieldname 

The name of a field within a record. 



MASK Operator 

Syntax: 

MASK record-field 

Description: 

Use of this operator defines a value that can be used to mask off fields in a record 
(i.e., a value with l's in those bit positions specified by the record field, and O's 
elsewhere), leaving only the record-field specified. This operator is used with an 
AND (or TEST) instruction with the operands being 1) the record stored either in a 
register or a memory location, and 2) an expression using the MASK operator. See 
the previous example for an illustration. 
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Field Values: 

record-field 

The name of a field within a record. 

WIDTH Operator 

Syntax: 

WIDTH rec 

Description: 

The WIDTH returns a value equal to the number of bits in either a record or a 
record field. From the above example: 

DB WIDTH AREC ;equals 16 

DB WIDTH C jequals 2 

Field Values: 

rec 

Either a record name or record field name. 



Operator Precedence 



The following is a list, in decreasing order of precedence, of the classes of operators. 
All expressions are evaluated from left to right following the precedence rules. You 
may override this order of evaluation and precedence through the use of 
parentheses. 



Highest Precedence 

1. Parenthesized expressions, angle-bracket (record) expressions, square-bracket 
expressions, the structure "dot" operator, and the operators LENGTH, SIZE, 
WIDTH, and MASK. 

2. PTR, OFFSET, SEG, TYPE, THIS, and "name:" (segment override). 

3. HIGH and LOW. 

4. Multiplication and division: *, /, MOD, SHR, SHL. 

5. Addition and subtraction: +, -. 

a. unary 

b. binary 

6. Relational: EQ, NE, LT, LE, GT, GE. 

7. Logical NOT. 

8. Logical AND. 

9. Logical OR and XOR. 
10. The SHORT operator. 

Lowest Precedence 
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The EQU Directive 



Syntax: 

equ-name EQU equ-value 



Description: 

The EQU directive is a very powerful means to define symbols for many of the 
ASM86 constructs. These symbols can form names that have more mnemonic value, 
or that form a "shorthand" notation for a complex construct. In the FIELD 
VALUE section below, many examples are given showing its use. 



Field Values: 
equ-name 

A unique ASM86 identifier. 

equ-value 

This field can have the following values: 

1 . A variable or label name (may be forward referenced). 

ALABEL EQU ALAB 
ALAB: MOV AX, 

2. An 8086/8088 register name. 

COUNT EQU CX 
POINTER EQU BX 



MOV COUNT, 10 ;CX = 10 

MOV POINTER, OFFSET ARRAY ;BX = offset 

; o f array 



3. 8086/8087/8088 instruction names. 

DATAM0VE EQU MOV 
INCREMENT EQU INC 

DATAM0VE AX, BX 
INCREMENT AX 

4. A numeric constant (integer or floating-point). 

PI EQU 3.14159 

TOTAL EQU 6 
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The precision of a floating-point number used in an EQUate is determined 
by the context in which it is used. For example, 

DD PI ; single precision 

DQ PI ; double precision 

5 . An assembly-time expression involving numeric values. 
E1 EQU 2 + 3 

E2 EQU E1 AND 4 

E3 EQU (E1 - E2) / 12 

6. A register expression. These may be single register expressions or they may 
also include a segment override. This construct is useful in defining data 
items to be accessed on the stack. 

STACKWORD EQU WORD PTR SS : [BP + 2] 

AVAR EQU [BX + 3] 

ANEXTRAVAR EQU ES : CBX] 
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Overview of Program Linkage 

ASM86 supplies the necessary directives to support multi-modular programs. A pro- 
gram may be composed of many individual modules (ASM86, PL/M-86, Pascal-86, 
or FORTRAN-86) that are separately assembled or compiled. Each module may 
define variables or labels that other modules may use. The mechanisms in ASM86 
for communicating symbol information from module to module are the 
PUBLIC/EXTRN directives. The PUBLIC directive defines those symbols that may 
be used by other modules. The EXTRN directive defines for a given module these 
symbols (defined elsewhere) that can be used. In order to uniquely name different 
object modules that are to be linked together, use the NAME directive. The END 
directive, which is required in all modules, can be used to specify a "main module," 
that is, a module which contains the code that will be initially executed upon loading 
the program. It supplies a means to specify the start address of the program that will 
be initialized by the loader. For assemblers running on 8086-based systems, 
initialization values for other segment registers may also be specified in the END 
directive. 



The PUBLIC Directive 

Syntax: 

PUBLIC name [,...] 

Description: 

The PUBLIC directive specifies which symbols in the module are available to other 
modules at link-time. These symbols may be variables, labels, or constants (17-bit 
numbers, defined using EQU). All other symbols will be flagged as an error. 

Field Values: 

name 

Any user-defined variable, label, or constant (17-bit number). 



The EXTRN Directive 

Syntax: 

EXTRN name:type [,...] 

Description: 

The EXTRN directive specifies those symbols, which may be referenced in the 
module, that have been declared "public" in another module. The EXTRN directive 
will specify the name of the symbol and its type. 
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Field Values: 

name 

The name of the symbol declared to be public in another module. 

type 

The type of the symbol declared public in another module. This type should 
agree with the type of the symbol declared public. This field can have the 
following values: 

1. BYTE — a variable of type byte. 

2. WORD— a variable of type word. 

3. DWORD— a variable of type dword. 

4. QWORD — a variable of type qword. 

5. TBYTE— a variable of type tbyte. 

6. A structure name: indicates a variable whose type is equal to the number of 
bytes allocated in the structure definition. 

7. A record name: type will be either a byte or word depending on the size of 
the record. 

8. NEAR— a label of type near. 

9. FAR— a label of type far. 

10. ABS— a constant (17-bit number), always of type word. 



The Placement of EXTRN's 

You must be careful in placing the EXTRN directive because the location of the 
EXTRN directive in relation to the definition of program segments is very critical. 
The following rules apply: 

1 . If you know the segment in which the external symbol is defined, then place 
the EXTRN directive between a SEGMENT/ENDS pair that is identical to 
the SEGMENT/ENDS pair in which the object was defined in the other 
module. The object can be used like any other variable or label. For exam- 
ple, if in the module SCAN.A86, you defined a variable such as the one 
below 

DATA SEGMENT WORD PUBLIC 

COUNT DB 

PUBLIC COUNT 

DATA ENDS 

you would place the EXTRN directive in the module, PARSE. A86, in the 
following way: 

DATA SEGMENT WORD PUBLIC 

EXTRN COUNT :BYTE 

DATA ENDS 
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2. If you do not know the segment in which the external symbol is defined, or 
if the segment in which it is defined is non-combinable, then place the 
EXTRN directive outside of all SEGMENT/ENDS pairs in your program. 
To address the external symbol you must load the segment part (paragraph 
number) of the symbol into a segment register using the SEG operator (see 
page 4-18). 

MOV AX, SEG COUNT 
MOV ES„ AX 

Then you must either use an ASSUME directive to verify addressability 
such as 

ASSUME ES : SEG COUNT 



MOV DX, COUNT 

or use a segment override (see page 4-14) for each use of that symbol. 

MOV DX, ES:C()UNT 

The END Directive 

Syntax: 

For 8080/8085 resident ASM86 assemblers: 

END [label name] 
For 8086 resident ASM86 assemblers: 
END [regint [,...]] 

Description: 

The END directive is required in all ASM86 module programs. It is, appropriately, 
the last statement in the module. Its occurrence terminates the assembly process; any 
text found beyond the END directive will be ignored (and an error will be issued). 
Another purpose of the END directive is to define the module as being a MAIN- 
MODULE. This implies that the code contained in the module will be the code that 
is initially executed when the program is loaded into memory. Execution will begin 
at the label in your code specified as the start address in the END directive. 

For the 8086 based assemblers, the END directive can also be used to define the 
initial contents of DS and SS. It specifies values to be placed in the segment registers 
by the loader as it loads the program prior to execution. If this alternate means of 
initializing these registers is used, then the initial values for CS:IP are required. You 
could also choose to write some code to do the same initialization. 

Example for 8080/8085 resident ASM86 assemblers: 
ASSUME CS:C0DE, DS:DATA 

DATA SEGMENT 

ABYTE DB 

DATA ENDS 
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CODE SEGMENT 

START: MOV AX, DATA 
MOV DS, AX 



; initialize DS 



CODE ENDS 

END START 

Example for 8086 resident ASM86 assemblers: 

ASSUME CS : CODE # DS:DATA, SS : STACK 

DATA SEGMENT 

ABYTE DB 

DATA ENDS 

STACK SEGMENT STACK 

DW 10 DUP (?) 
STACKTOP DW 

STACK ENDS 

CODE SEGMENT 

START: MOV AL, ABYTE ;DS is already initialized 



CODE ENDS 

END START, DS:DATA, SS : STACK : STACKTOP 



CS:IP points to 
CODE : START 
DS points to DATA 
SS : SP poi nts to 
STACK : STACKTOP 



Field Values: 

[label name] 

The name of a label defined in the module. This label defines that point in the 
code where execution of the program should begin. 



[regint] 



This field defines the contents for a segment register (and also the registers IP 
and SP). To initialize the segment registers, the following formats apply: 

'Segname' is either a segment name or a group name. It identifies the paragraph 
number to be loaded into the segment register. 
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'Labelname' is the name of a label defined in the module. Its offset will be used 
to initialize IP. 

'Varname' is the name of a variable defined in the module. Its offset will be 
used to initialize SP. 

To initialize CS and IP: 



labelname 

or 
CS:labelname 

or 
CS:segname:labelname 



To initialize SS and SP: 

SS:segname: varname 

or 
SS:segname 



To initialize DS: 
DS:segname 



(the segment part of the label is used for CS) 

(same as "labelname") 

(the segment part or paragraph number that is 
to be loaded into CS is taken from segname) 

(SP will be initialized to the offset of varname) 

(SP will be initialized to be equal to the size of 
the segment) 



The NAME Directive 

Syntax: 

NAME modname 



Description: 

The NAME directive is used to define a name for the object module. Each module 
that will be linked to others must have a unique name. The NAME directive can be 
used to specify this name. 

For 8080/8085 resident ASM86 assemblers, the default object module name is the 
source file name stripped of its extension. For example, if the source file name is 
SCAN.A86, the object mode name will be SCAN. This occurs if no NAME directive 
is used. 

For 8086 resident ASM86 assemblers, the NAME directive must be used. If it is not 
used, an error will occur and the assembler will give the object module the default 
name ANONYMOUS. Using this default name can cause problems when linking 
together assembly language modules. LIB-86 will report an error if two modules 
have the same name. 

Field Values: 

modname 

A user-defined identifier. Hands-off and dual-function keywords are invalid 
and will cause an error. 
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CHAPTER 6 

THE 8086/8087/8088 

INSTRUCTION SET 



The 8086/8088 Instruction Set 



Instruction Statement Formats 

The format for the instruction statement was introduced in Chapter 4. The format is 
shown below: 

[label:] [prefix] mnemonic [operand [, operand]] 

This chapter describes the 8086/8087/8088 instruction set. The instruction set con- 
sists of a set of mnemonics that select different machine operations. The instruction 
set encyclopedia at the end of this chapter describes each of these mnemonics, their 
operations, and allowed operands. 



Addressing Modes 

The 8086 instruction set provides several different ways to address operands. Most 
two-operand instructions allow either memory or a register to serve as one operand, 
and either a register or a constant within the instruction to serve as the other 
operand. Memory to memory operations are excluded. 

Operands in memory may be addressed directly with a 16-bit offset address, or 
indirectly with base (BX or BP) and/or index (SI or DI) registers added to an 
optional 8- or 16-bit displacement constant. This constant can be the name of a 
variable or a pure number. When a name is used, the displacement constant is the 
variable's offset (see Chapter 4). 

The result of a two-operand operation may be directed to either memory or a 
register. Single-operand operations are applicable uniformly to any operand except 
immediate constants. Virtually all 8086 operations may specify either 8- or 16-bit 
operands. 



Memory Operands 

Operands residing in memory may be addressed in four ways: 

• Direct 16-bit offset address 

• Indirect through a base register, BX or BP, optionally with an 8- or 16-bit 
displacement 

• Indirect through an index register, SI or DI, optionally with an 8- or 16-bit 
displacement 

• Indirect through the sum of one base register and one index register, optionally 
with an 8- or 16-bit displacement. 

The location of an operand in an 8086 register or in memory is specified by up to 
three fields in each instruction. These fields are the mode field (mod), the register 
field (reg), and the register/memory field (r/m). When used, they occupy the second 
byte of the instruction sequence. This byte is referred to as the Modrm byte of the 
instruction. 
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The mode field occupies the two most significant bits, 7 and 6, of the byte, and 
specifies how the r/m field (bits 2, 1,0) is used in locating the operand. The r/m 
field can name a register that holds the operand or can specify an addressing mode 
(in combination with the mod field) that points to the location of the operand in 
memory. The reg field occupies bits 5, 4, and 3 following the mode field, and can 
specify that one operand is either an 8-bit register or a 16-bit register. In some 
instructions, this reg field gives additional bits of information specifying the instruc- 
tion, rather than only encoding a register. 

Description 

The effective address (EA) of the memory operand is computed according to the 
mod and r/m fields: 

if mod = 00 then DISP = 0*, disp-low and disp-high are absent 

if mod = 01 then DISP = disp-low sign-extended to 16 bits, disp-high is absent 

if mod = 10 then DISP = disp-high:disp-low 

if r/m = 000 then EA = (BX) + (SI) + DISP 

if r/m = 001 then EA = (BX) + (Dl) + DISP 

if r/m = 010 then EA = (BP) + (SI) + DISP 

if r/m = 011 then EA = (BP) + (Dl) + DISP 

if r/m = 100 then EA = (SI) + DISP 

if r/m = 101 then EA = (DI) + DISP 

if r/m = 110 then EA = (BP) + DISP* 

if r/m = 111 then EA = (BX) + DISP 

*except if mod = 00 and r/m = 110 then 
EA = disp-high: disp-low 

Instructions referencing 16-bit objects interpret EA as addressing the low-order 
byte; the word is addressed by EA+1 ,EA. 

Encoding 



mod reg r/m 


disp-low 


disp-high 



Segment Override Prefixes 

General register BX and pointer register BP may serve as base registers. When BX is 
the base the operand by default resides in the current Data Segment and the DS 
register is used to compute the physical address of the operand. When BP is the 
base, the operand by default resides in the current Stack Segment and the SS seg- 
ment register is used to compute the physical address of the operand. When both 
base and index registers are used, the operand by default resides in the segment 
determined by the base register, i.e., BX means DS is used, BP means SS is used. 
When an index register alone is used, the operand by default resides in the current 
Data Segment. The physical address of most other memory operands is by default 
computed using the DS segment register (exceptions are noted below). These 
assembler-default segment register selections may be overridden by preceding the 
referencing instruction with a segment override prefix. 

Description 

The segment register selected by the reg field of a segment prefix is used to compute 
the physical address for the instruction this prefix precedes. This prefix may be com- 
bined with the LOCK and/or REP prefixes, although the latter has certain require- 
ments and consequences — see REP. 
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Encoding 



001 regl 10 



reg is assigned according to the following table: 

Segment 



00 


ES 


01 


CS 


10 


ss 


11 


DS 



Exceptions 

The physical addresses of all operands addressed by the SP register are computed 
using the SS segment register, which may not be overridden. The physical addresses 
of the destination operands of the string primitive operations (those addressed by 
the DI register) are computed using the ES segment, which may not be overridden. 



Register Operands 

The four 16-bit general registers and the four 16-bit pointer and index registers may 
serve interchangeably as operands in nearly all 16-bit operations. Three exceptions 
to note are multiply, divide, and some string operations, which use the AX register 
implicitly. The eight 8-bit registers of the HL group may serve interchangeably in 8- 
bit operations. Multiply, divide, and some string operations use AL implicitly. 

Description 

Register operands may be indicated by a distinguished field, in which case REG will 
represent the selected register, or by an encoded field, in which case EA will repre- 
sent the register selected by the r/m field. Instructions without a "w" bit always 
refer to 16-bit registers (if they refer to any register at all); those with a "w" bit refer 
to either 8- or 16-bit registers according to "w". 



Encoding 

General Registers: 

Distinguished Field: 



reg 



reg 



for mode = 11 EA = r/m (a register): 



11 reg 



REG is assigned according to the following table: 

16-Bit [w = 1] 8-Bit [w = 0] 



000 AX 


000 AL 


001 CX 


001 CL 


010 DX 


010 DL 


011 BX 


011 BL 


100 SP 


100 AH 


101 BP 


101 CH 


110 SI 


110 DH 


111 DI 


111 BH 
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Instructions that reference the flag register file as a 16-bit object use the symbol 
FLAGS to represent the file: 

FLAGS X:X:X:X:(OF):(DF):(IF):(TF):(SF):(ZF):X:(AF):X:(PF):X:(CF) 

where X is undefined. 

Immediate Operands 

All two-operand operations except multiply, divide, and the string operations allow 
one source operand to appear within the instruction as immediate data. Sixteen-bit 
immediate operands that have a high-order byte that is the sign extension of the low- 
order byte may be abbreviated to eight bits. 

Three points about immediate operands: 

• Immediate operands always follow addressing mode displacement constants 
(when present) in the instruction. 

• The low-order byte of 16-bit immediate operands always precedes the 
high-order byte. 

• The 8-bit immediate operands of instructions with s:w = 1 1 are sign-extended to 
16-bit values. 

String Instructions and Memory References 

Table 6-1 shows the mnemonics of the string instructions that can be coded without 
operands (MOVSB, MOVSW, etc.) or with operands (MOVS, etc.). 

The string instructions are unusual in several respects: 

1 . Before coding a string instruction, you must: 

• Load SI with the offset of the source string. 

• Load DI with the offset of the destination string. 

2. One of the forms of REP (REP, REPZ, REPE, REPNE, REPNZ) can be coded 
immediately preceding (but separated from by at least one blank) the primitive 
string operation mnemonic (thus, REPNZ SCASW is one possibility). This 
specifies that the string operation is to be repeated the number of times deter- 
mined by CX. (Refer to instruction descriptions.) 

3. Each can be coded with or without symbolic memory operands. 

• If symbolic operands are coded, the assembler can check the addressability 
of the operands. 

Table 6-1 . String Instruction Mnemonics 



Operation 


Mnemonic if 


Mnemonic if 


Mnemonic if 


Being 


Operand Is 


Operand Is 


Symbolic Operands 


Performed 


Byte String 


Word String 


Are Coded* 


Move 


MOVSB 


MOVSW 


MOVS 


Compare 


CMPSB 


CMPSW 


CMPS 


Load AL/AX 


LODSB 


LODSW 


LODS 


Store from AL/AX 


STOSB 


STOSW 


STOS 


Compare to AL/AX 


SCASB 


SCASW 


SCAS 


Block Input 


INSB 


INSW 


INS 


Block Output 


OUTSB 


OUTSW 


OUTS 



Mf symbolic operands are coded, the assembler can check their addressability. Also, their 
TYPEs determine the opcode generated. 
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• Anonymous references that use the hardware defaults should be coded 
using the operand-less forms (e.g. MOVSB, MOVSW), to avoid the 
cumbersome (but otherwise required): 

MOVS E S : B Y T E PTR [DI], [SI] 

as opposed to the simple: 

MOVSB 

• Anonymous references that do not use the hardware defaults require both 
segment and type to be explicitly specified: 

MOVS ES : BYTE PTR CDI] , SS: [SI] 

• Never use [BX] or [BP] addressing modes with string instructions. 

4 If the instruction mnemonic is coded without operands (e.g., MOVSB, 
MOVSW), then the segment register defaults are as follows: 

• SI defaults to an offset in the segment addressed by DS, 

• DI is required to be an offset in the segment addressed by ES. 

Thus, the direction of data flow for the default case in which no operands are 
specified is from the segment addressed by DS to the segment addressed by ES. 

5. If the instruction mnemonic is coded with operands (e.g. MOVS, CMPS), the 
operands can be anonymous (indirect) or they can be variable references. 

Example: 

DESTSTRING EQU ES : BYTE PTR [DI] 

SRCSTRING EQU DS : BYTE PTR [SI] 

ASSUME CS'.CODE, DS : DATA , ES : DATA1 

DATA SEGMENT 

SRCARRAY DB 10 DUP (1) 

DATA ENDS 

DATA1 SEGMENT 

DESTARRAY DB 10 DUP (?) 

DATA1 ENDS 

CODE SEGMENT 

MOV AX, DATA 

MOV DS, AX ; IN IT DS 

MOV AX, DATA1 

MOV ES, AX ; IN IT ES 

MOV SI, OFFSET SRCARRAY 
MOV DI, OFFSET DESTARRAY 

; I N IT POINTER REGISTERS 

MOV CX, 10 ;NUMBER OF ELEMENTS 
REP MOVS DESTSTRING, SRCSTRING 
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PERFORM STRING OPERATION 



CODE ENDS 



Mnemonic Synonyms 

There are some machine operations that can have different mnemonics. The dif- 
ferent mnemonics are all synonyms in that they refer to the same machine instruc- 
tions. They are supplied by the assembler to allow you to think of the operation in 
terms that are more helpful for your task. Many of the conditional jump instruc- 
tions have more than one mnemonic. When used after a compare, the conditional 
jump mnemonic can express the type of compare or the result of the compare in 
terms of the flags that were set. For example, 



CMP DEST, 
JE LAB1 



SRC 



jump if dest is equal to source 



or 

CMP 
JZ 



DEST, 
LAB1 



SRC 



jump if zero flag set (dest = src) 



In both cases, the same instruction will be encoded for the jump. Programmers 
familiar with other assembly languages that use conditional jump mnemonics that 
refer to flags may be more comfortable using this form. However, the first form that 
expresses the relationship the compare is checking between the operands is more 
expressive. 



Organization of the Instruction Set 

Instructions are described in this section in six functional groups: 

• Data transfer 

• Arithmetic 

• Logic 

• String manipulation 

• Control transfer 

• Processor control 



Each of the first three groups mentioned in the preceding list is further subdivided 
into an array of codes that specify whether the instruction is to act upon immediate 
data, register or memory locations, whether 16-bit words, or 8-bit bytes are to be 
processed, and what addressing mode is to be employed. All of these codes are listed 
and explained in detail, but you do not have to code each one individually. The con- 
text of your program automatically causes the assembler to generate the correct 
code. There are three general categories of instructions within each of the three func- 
tional groups mentioned: 

1 . Register or memory space to or from register 

2. Immediate data to register or memory 

3. Accumulator to or from registers, memory, or ports 
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Data Transfer 

Data transfer operations are divided into four classes: 

1 general purpose 

2 accumulator-specific 

3 address-object 

4 flag 

None affect flag settings except SAHF and POPF. 



General Purpose Transfers 

Four general purpose data transfer operations are provided. These may be applied 
to most operands, though there are specific exceptions. The general purpose 
transfers (except XCHG) are the only operations that allow a segment register as an 
operand. 

— MOV performs a byte or word transfer from the source (rightmost) operand to 
the destination (leftmost) operand. 

— PUSH decrements the SP register by two and then transfers a word from the 
source operand to the stack element currently addressed by SP. 

— POP transfers a word operand from the stack element addressed by the SP 
register to the destination operand and then increments SP by 2. 

— XCHG exchanges the byte or word source operand with the destination operand. 
The segment registers may not be operands of XCHG. 



Accumulator-Specific Transfers 

Three accumulator-specific transfer operations are provided: 

— IN transfers a byte (or word) from an input port to the AL register (or AX 
register). The port is specified either with an inline data byte, allowing fixed 
access to ports through 255, or with a port number in the DX register, allowing 
variable access to 64K input ports. 

— OUT is similar to IN except that the transfer is from the accumulator to the 
output port. 

— XLAT performs a table lookup byte translation. The AL register is used as an 
index into a 256-byte table addressed by the BX register. The byte operand so 
selected is transferred to AL. 



Address-Object Transfers 

Three address-object transfer operations are provided: 

— LEA (load effective address) transfers the offset address of the source operand to 
the destination operand. The source operand must be a memory operand and the 
destination operand must be a 16-bit general, pointer, or index register. 

— LDS (load pointer into DS) transfers a "pointer-object" (i.e., a 32-bit object 
containing an offset address and a segment address) from the source operand 
(which must be a doubleword memory operand) to a pair of destination registers. 
The segment address is transferred to the DS segment register. The offset address 
is transferred to the 16-bit general, pointer, or index register that you coded. 

— LES (load pointer into ES) is similar to LDS except that the segment address is 
transferred to the ES segment register. 
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Flag Register Transfers 

Four flag register transfer operations are provided: 

— LAHF (load AH with flags) transfers the flag registers SF, ZF, AF, PF, and CF 
(the 8080 flags) into specific bits of the AH register. 

— SAHF (store AH into flags) transfers specific bits of the AH register to the flag 
registers, SF, ZF, AF, PF, and CF. 

— PUSHF (push flags) decrements the SP register by two and transfers all of the 
flag registers into specific bits of the stack element addressed by SP. 

— POPF (pop flags) transfers specific bits of the stack element addressed by the SP 
register to the flag registers and then increments SP by two. 

Arithmetic 

The 8086/8088 provides the four basic mathematical operations in a number of dif- 
ferent varieties. Both 8- and 16-bit operations and both signed and unsigned 
arithmetic are provided. Standard twos complement representation of signed values 
is used. The addition and subtraction operations serve as both signed and unsigned 
operations. In these cases the flag settings allow the distinction between signed and 
unsigned operations to be made (see Conditional Transfer). Correction operations 
are provided to allow arithmetic to be performed directly on unpacked decimal 
digits or on packed decimal representations. 

Flag Register Settings 

Six flag registers are set or cleared by arithmetic operations to reflect certain proper- 
ties of the result of the operation. They generally follow these rules (see also Appen- 
dix C): 

— CF is set if the operation results in a carry out of (from addition) or a borrow into 
(from subtraction) the high-order bit of the result; otherwise, CF is cleared. 

— AF is set if the operation results in a carry out of (from addition) or a borrow into 
(from subtraction) the low-order four bits of the result; otherwise, AF is cleared. 

— ZF is set if the result of the operation is zero; otherwise, ZF is cleared. 

— SF is set if the high-order bit of the result of the operation is set; otherwise, SF is 
cleared. 

— PF is set if the modulo 2 sum of the low-order eight bits of the result of the 
operation is (even parity); otherwise, PF is cleared (odd parity). 

— OF is set if the operation results in a carry into the high-order bit of the result but 
not a carry out of the high-order bit, or vice versa; otherwise, OF is cleared. 

Addition 

Five addition operations are provided: 

— ADD performs an addition of the source and destination operands and returns 
the result to the destination operand. 

— ADC (add with carry) performs an addition of the source and destination 
operands, adds one if the CF flag is found previously set, and returns the result to 
the destination operand. 

— INC (increment) performs an addition of the source operand and one, and 
returns the result to the operand. 

— AAA (unpacked BCD (ASCII) adjust for addition) performs a correction of the 
result in AL of adding two unpacked decimal operands, yielding an unpacked 
decimal sum. 

— DAA (decimal adjust for addition) performs a correction of the result in AL of 
adding two packed decimal operands, yielding a packed decimal sum. 
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Subtraction 

Seven subtraction operations are provided: 

— SUB performs a subtraction of the source from the destination operand and 
returns the result to the destination operand. 

— SBB (subtract with borrow) performs a subtraction of the source from the 
destination operand, subtracts one if the CF flag is found previously set, and 
returns the result to the destination operand. 

— DEC (decrement) performs a subtraction of one from the source operand and 
returns the result to the operand. 

— NEG (negate) performs a subtraction of the source operand from zero and 
returns the result to the operand. 

— CMP (compare) performs a subtraction of the source destination operand, 
causing the flags to be affected, but does not return the result. 

— AAS (unpacked BCD (ASCII) adjust for subtraction) performs a correction of 
the result in AL of subtracting two unpacked decimal operands, yielding an 
unpacked decimal difference. 

— DAS (decimal adjust for subtraction) performs a correction of the result in AL of 
subtracting two packed decimal operands, yielding a packed decimal difference. 



Multiplication 

Three multiplication operations are provided: 

— MUL performs an unsigned multiplication of the accumulator (AL or AX) and 
the source operand, returning a double length result to the accumulator and its 
extension (AL and AH for 8-bit operation, AX and DX for 16-bit operation). CF 
and OF are set if the top half of the result is non-zero. 

— IMUL (integer multiply) is similar to MUL except that it performs a signed 
multiplication. CF and OF are set if the top half of the result is not the sign- 
extension of the low half of the result. 

— AAM (unpacked BCD (ASCII) adjust for multiply) performs a correction of the 
result in AX of multiplying two unpacked decimal operands, yielding an 
unpacked decimal product. 



Division 

There are three division operations provided and two sign-extension operations to 
support signed division: 

— DIV performs an unsigned division of the accumulator and its extension (AL and 
AH for 8-bit operation, AX and DX for 16-bit operation) by the source operand 
and returns the single length quotient to the accumulator (AL or AX), and 
returns the single length remainder to the accumulator extension (AH or DX). 
The flags are undefined. Division by zero generates an interrupt of type 0. 

— IDIV (integer division) is similar to DIV except that it performs a signed division. 

— AAD (unpacked BCD (ASCII) adjust for division) performs a correction of the 
dividend in AL before dividing two unpacked decimal operands, so that the result 
will yield an unpacked decimal quotient. 

— CBW (convert byte to word) performs a sign extension of AL into AH. 

— CWD (convert word to double word) performs a sign extension of AX into DX. 
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Logic 

The 8086/8088 provides the basic logic operations for both 8- and 16-bit operands. 

Single-Operand Operations. Three-single-operand logical operations are provided: 

— NOT forms the one's complement of the source operand and returns the result to 
the operand. Flags are not affected. 

— Shift operations of four varieties are provided for memory and register operands: 
SHL (shift logical left), SHR (shift logical right), SAL (shift arithmetic left), and 
SAR (shift arithmetic right). Single bit shifts, and variable bit shifts with the shift 
count taken from the CL register are available. The CF flag becomes the last bit 
shifted out, OF is defined only for shifts with count of 1, and is set if the final 
sign bit value differs from the previous value of the sign bit, and PF, SF, and ZF 
are set to reflect the resulting value. 

— Rotate operations of four varieties are provided for memory and register 
operands: ROL (rotate left), ROR (rotate right), RCL (rotate through CF left), 
and RCR (rotate through CF right). Single bit rotates, and variable bit rotates 
with the rotate count taken from the CL register, are available. The CF flag 
becomes the last bit rotated cut; OF is defined only for shifts with count of 1, and 
is set if the final sign bit value differs from the previous value of the sign bit. 

Two-Operand Operations 

Four two-operand logical operations are provided. The CF and OF flags are cleared 
on all operations; SF, PF, and ZF reflect the result. 

— AND performs the bitwise logical conjunction of the source and destination 
operand and returns the result to the destination operand. 

— TEST performs the same operations as AND, causing the flags to be affected but 
does not return the result. 

— OR performs the bitwise logical inclusive disjunction of the source and 
destination operand and returns the result to the destination operand. 

— XOR performs the bitwise logical exclusive disjunction of the source and 
destination operand and returns the result to the destination operand. 

String Manipulation 

One-byte instructions perform various primitive operations for the manipulation of 
byte and word strings (sequences of bytes or words). Any primitive operation can be 
performed repeatedly in hardware by preceding its instruction with a repeat prefix 
(see REP). The single-operation forms may be combined to form complex string 
operations with repetition provided by iteration operations. 

Hardware Operation Control 

All primitive string operations use the SI register to address the source operands. 
The DI register is used to address the destination operands that reside in the current 
extra segment. If the DF flag is cleared, the operand pointers are incremented after 
each operation, once for byte operations and twice for word operations. If the DF 
flag is set, the operand pointers are decremented after each operation. See Processor 
Control for setting and clearing DF. 

Any of the primitive string operation instructions may be preceded with a one-byte 
prefix indicating that the operation is to be repeated until the operation count in CX 
is satisfied. The test for completion is made prior to each repetition of the operation. 
Thus, an initial operation count of zero in CX will cause zero executions of the 
primitive operation. 
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The repeat prefix byte also designates a value to compare with the ZF flag. If the 
primitive operation is one that affects the ZF flag, and the ZF flag is unequal to the 
designated value after any execution of the primitive operation, the repetition is ter- 
minated. This permits the scan operation, for example, to serve as a scan-while or a 
scan-until. 



During the execution of a repeated primitive operation, the operand index registers 
(SI and DI) and the operation count register (CX) are updated after each repetition, 
whereas the instruction pointer will retain the offset address of the repeat prefix byte 
(assuming it immediately precedes the string operation instruction). Thus, an inter- 
rupted repeated operation will be correctly resumed when control returns from the 
interrupting task. 



Using more than one prefix on an instruction is processor dependent. Please refer to 
the User's Manual for your processor for further information. 



Primitive String Operation 

Five primitive string operations are provided: 

— MOVS (MOVSB, MOVSW) transfers a byte (or word) operand from the source 
(rightmost) operand to the destination (leftmost) operand. As a repeated opera- 
tion, this provides for moving a string from one location in memory to another. 

— CMPS (CMPSB, CMPSW) subtracts the rightmost byte (or word) operand from 
the leftmost operand and affects the flags but does not return the result. As a 
repeated operation, this provides for comparing two strings. With the appro- 
priate repeat prefix it is possible to determine after which string element the two 
strings become unequal, thereby establishing an ordering between the strings. 

— SCAS (SCASB, SCASW) subtracts the destination byte (or word) operand from 
AL (or AX) and affects the flags but does not return the result. As a repeated 
operation, this provides for scanning for the occurrence of, or departure from, a 
given value in the string. 

— LODS (LODSB, LODSW) transfers a byte (or word) operand from the source 
operand to AL (or AX). This operation ordinarily would not be repeated. 

— STOS (STOSD, STOSW) transfers a byte (or word) operand from AL (or AX) to 
the destination operand. As a repeated operation, this provides for filling a string 
with a given value. 



In all the cases above, the source operand is addressed by SI and the destination 
operand is addressed by DI. Only in CMPB/CMPW does the Dl-indexed operand 
appear as the rightmost operand. 
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Software Operation Control 

The repeat prefix provides for rapid iteration in a hardware-repeated string opera- 
tion. The iteration control operations (see LOOP) provide this same control for 
implementing software loops to perform complex string operations. These iteration 
operations provide the same operation count update, operation completion test, and 
ZF flag tests that the repeat prefix provides. 

By combining the primitive string operations and iteration control operations with 
other operations, it is possible to build sophisticated yet efficient string manipula- 
tion routines. One instruction that is particularly useful in this context is XLAT. It 
permits a byte fetched from one string to be translated before being stored in a sec- 
ond string, or before being operated upon in some other fashion. The translation is 
performed by using the value in the AL register as an index into a table pointed at by 
the BX register. The translated value obtained from the table then replaces the value 
initially in the AL register (see XLAT). 



Control Transfer 

Four classes of control transfer operations may be distinguished: calls, jumps, and 
returns; conditional transfers; iteration control; and interrupts. 

All control transfer operations cause the program execution to continue at some new 
location in memory, possibly in a new code segment. Conditional transfers are pro- 
vided for targets in the range -128 to +127 bytes from the transfer. 



Calls, Jumps, and Returns 

Two basic varieties of calls, jumps, and returns are provided— those that transfer 
control within the current code segment, and those that transfer control to an arbi- 
trary code segment, which then becomes the current code segment. Both direct and 
indirect transfers are supported; indirect transfers make use of the standard address- 
ing modes as described in above. 

The three transfer operations are described below. 

— CALL pushes the offset address of the next instruction onto the stack (in the case 
of an inter-segment transfer the CS segment register is pushed first) and then 
transfers control to the target operand. 

— JMP transfers control to the target operand. 

— RET transfers control to the return address saved by a previous CALL operation, 
and optionally may adjust the SP register so as to discard stacked parameters. 

Intra-segment direct calls and jumps specify a self-relative direct displacement, thus 
allowing position independent code. A shortened jump instruction is available for 
transfers in the range -128 to +127 bytes from the instruction for code compaction. 



Conditional Jumps 

The conditional transfers of control perform a jump contingent upon various 
Boolean functions of the flag registers. The destination must be within a -128 to 
+ 127 byte range of the instruction. Table 6-2 shows the available instructions, the 
conditions associated with them, and their interpretation. 
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Table 6-2. 8086/8087 Conditional Transfer Operations 



Instruction 


Condition 


Interpretation 


JEorJZ 


ZF = 1 


"equal" or "zero" 


JLorJNGE 


(SFxorOF) = 1 


"less" or "not greater or equal" 


JLEorJNG 


((SFxorOF)orZF) = 
1 


"less or equal" or "not greater" 


JBorJNAE 
or JC 


CF=I 


"below" or "not above or equal" 
or "carry" 


JBEorJNA 


(CForZF) = 1 


"below or equal" or "not above" 


JPorJPE 


PF = 1 


"parity" or "parity even" 


JO 


OF = 1 


"overflow" 


JS 


SF = 1 


"sign" 


JNEorJNZ 


ZF = 


"not equal" or "notzero" 


JNLorJGE 


(SFxorOF) = 


"not less" or "greater or equal" 


JNLEorJG 


((SFxorOF)orZF) = 



"not less or equal" or "greater" 


JNBorJAE 
orJNC 


CF = 


"not below" or "above or equal" 
or "no carry" 


JNBEorJA 


(CForZF) = 


"not below or equal" or "above" 


JNPorJPO 


PF = 


"not parity" or "parity odd" 


JNO 


OF = 


"not overflow" 


JNS 


SF = 


"not sign" 



'"Above" and "below" refer to the relation between two unsigned values, while "greater' 
and "less" refer to the relation between two signed values. 



Iteration Control 

The iteration control transfer operations perform leading- and trailing-decision loop 
control. The destination of iteration control transfers must be within a -128 to +127 
byte range of the instruction. These operations are particularly useful in conjunction 
with the string manipulation operations. 

There are four iteration control transfer operations provided: 

— LOOP decrements the CX ("count") register by one and transfers if CX is not 
zero. 

— LOOPZ (also called LOOPE) decrements the CX register by one and transfers if 
CX is not zero and the ZF flag is set (loop while zero or loop while equal). 

— LOOPNZ (also called LOOPNE) decrements the CX register by one and 
transfers if CX is not zero and the ZF flag is cleared (loop while not zero or loop 
while not equal). 

— JCXZ transfers if the CX register is zero. 



Interrupts 

Program execution control may be transferred by means of operations similar in 
effect to that of external interrupts. All interrupts perform a transfer by pushing the 
flag registers onto the stack (as in PUSHF), and then performing an indirect inter- 
segment call through an element of an interrupt transfer vector located at absolute 
locations through 3FFH. This vector contains a four-byte element for each of up 
to 256 different interrupt types. 
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Three interrupt transfer operations provided. 

— INT pushes the flag registers (as in PUSHF), clears the TF and IF flags, and 
transfers control with an indirect call through any one of the 256 vector elements. 
A one-byte form of this instruction is available for interrupt type 3. 

— INTO pushes the flag registers (as in PUSHF), clears the TF and IF flags, and 
transfers control with an indirect call through vector element 4 if the OF flag is set 
(trap on overflow). If the OF flag is cleared, no operation takes place. 

— IRET transfers control to the return address saved by a previous interrupt 
operation and restores the saved flag registers (as in POPF). 



Processor Control 

Various instructions and mechanisms are provided for control and operation of the 
processor and its interaction with its environment. 



Flag Operations 

There are seven operations provided that operate directly on individual flag 
registers. 

— CLC clears the CF flag. 

— CMC complements the CF flag. 

— STC sets the CF flag. 

— CLD clears the DF flag, causing the string operations to auto-increment the 
operand pointers. 

— STD sets the DF flag, causing the string operations to auto-decrement the 
operand pointers. 

— - CLI clears the IF flag, disabling external interrupts (except for the non-maskable 
external interrupt). 

— STI sets the IF flag, enabling external interrupts after the execution of the next 
instruction. 

Processor Halt 

The HLT instruction causes the 8086 processor to enter its halt state. The halt state 
is cleared by an enabled external interrupt or RESET. 

Processor Wait 

The WAIT instruction causes the processor to enter a wait state if the signal on its 
TEST pin is not asserted. The wait state may be interrupted by an enabled external 
interrupt. When this occurs the saved code location is that of the WAIT instruction, 
so that upon return from the interrupting task, the wait state is re-entered. The wait 
state is cleared and execution resumed when the TEST signal is asserted. Execution 
resumes without allowing external interrupts until after the execution of the next 
instruction. This instruction allows the processor to synchronize itself with external 
hardware. 

Processor Escape 

The ESC instruction provides a mechanism by which other processors may receive 
their instructions from the 8086 instruction stream and make use of the 8086 
addressing modes. The 8086 processor does no operation for the ESC instruction 
other than to access a memory operand. 
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Bus Lock 

A special one-byte prefix may precede any instruction causing the processor to assert 
its bus-lock signal for the duration of the operation caused by that instruction. This 
has use in multiprocessing applications (see LOCK). 



Single Step 

When the TF flag register is set, the processor generates a type 1 interrupt after the 
execution of each instruction. During interrupt transfer sequences caused by any 
type of interrupt, the TF flag is cleared after the push-flags step of the interrupt 
sequence. No instructions are provided for setting or clearing TF directly. Rather, 
the flag register image saved on the stack by a previous interrupt operation must be 
modified, so that the subsequent interrupt return operation (IRET) restores TF set. 
This allows a diagnostic task to single-step through a task under test, while still exe- 
cuting normally itself. 

If the single-stepped instruction itself clears the TF flag, the type 1 interrupt will still 
occur upon completion of the single-stepped instruction. If the single-stepped 
instruction generates an interrupt or if an enabled external interrupt occurs prior to 
the completion of the single-stepped instruction, the type 1 interrupt sequence will 
occur after the interrupt sequence of the generated or external interrupt, but before 
the first instruction of the interrupt service routine is executed. 

The 8086/8088 hardware protects the execution of the instruction immediately 
following a POP or a MOV to a segment register instruction from any kind of inter- 
rupt, including type 1 interrupts used to single-step. When single-stepping through a 
task under test, the single-step interrupt is not recognized until the instruction 
following the POP or MOV to a segment register instruction is executed. 



Example 

TEST_TASK 



INSTRUC1 
INSTRUC2 
INSTRUC3 



TEST_TASK ENDS 



SEGMENT 




ASSUME 


CS:TEST 


POP 


DS 


POP 


BX 


ADD 


AX, [BX] 



TASK 



When single-stepping through TEST__TASK, INSTRUCT steps to INSTRUC3 
since the single-step interrupt is not recognized by the 8086/8088 until the instruc- 
tion following the POP to the DS segment register (POP BX) is executed. 



Instruction Description Formats 

The formats presented in the individual instruction descriptions and briefly dis- 
cussed here reflect the assembly language processed by the 8086/8087/8088 Macro 
Assembler (ASM86). 
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Format Boxes 

The individual instruction descriptions show first a format box such as the following 
example. 



Mem/Reg * Immediate to Reg 



Opcode 



ModRM 



Data 



Zl 



These are byte-wise representations of the object code generated by the assembler 
and are interpreted as follows: 

• Opcode is the 8-bit opcode for the instruction. The actual opcode generated is 
defined in the "Opcode" column of the instruction table that follows each 
format box. 

• ModRM is the byte that specifies the operands of the instruction. It contains a 
2-bit mode field (MOD), a 3-bit register field (REG), and a 3-bit Register or 
Memory (R/M) field. 

• Dashed blank boxes following the ModRM box are for any displacement 
required by the mode field. 

• Data is for a byte of immediate data. 

• A dashed blank box following a Data box is used whenever the immediate 
operand is a word quantity. 



Instruction Detail Tables 

Following each format box, an instruction detail table shows the opcode, the 
number of clocks required for the operation to take place, the actual operation per- 
formed, and a coding example for each variant of the instruction. 

The instruction detail table for the instruction IMUL is shown below. The examples 
in the table are neither complete nor restrictive; anyplace there is a memory operand, 
any of the seven memory addressing modes can be used. 



icode 


Clocks 


Operation 


Coding Example 


F6 


80-98 


AX*-AL* Reg 8 


IMUL BL 


F6 


(86-104) + EA 


AX-AL* Mem 8 


IMUL BYTESOMETHING 


F7 


128-154 


DX:AX-AX* Reg 16 


IMUL BX 


F7 


(134-1 60) + EA 


DX:AX-AX* Mem 16 


IMUL WORDSOMETHING 



Flags 

The flags produced by each instruction are represented by a table such as the 
following: 

0DITSZAPC 
X---UUUUX 
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The top line in the table represents the individual flags, and the lower line shows the 
effect on each flag by the instruction. The letters, numbers and symbols used in the 
table are defined as follows: 



Flag 



Definition 






Overflow 


D 


Direction (used in string ops) 


1 

T 
S 


Interrupt Enable (1=enabled) 

Single Step Trap Flag (causes interrupt 1 after next instruction 

Sign 


z 


Zero 


A 
P 
C 


Auxiliary Carry (used primarily in BCD ops) 

Parity 

Carry 


Effect 
Code 


Effect 



Modified by the instruction; result depends on operands. 

Not modified. 

Undefined after the instruction. 

Set to 1 by the instruction. 

Set to by the instruction. 



Table 6-3. Symbols 



8086/8088 
Descriptor 


Meaning 


AX 


Accumulator (16-bit) 


AH 


Accumulator (high-order byte) 


AL 


Accumulator (low-order byte) 


BX 


Register BX (16-bit), which may be split and addressed as two 
8-bit registers. 


BH 


High-order byte of register BX. 


BL 


Low-order byte of register BX. 


CX 


Register CX (16-bit), which may be split and addressed as two 
8-bit registers. 


CH 


High-order byte of register CX. 


CL 


Low-order byte of register CX. 


DX 


Register DX (16-bit), which may be split and addressed as two 
8-bit registers. 


DH 


High-order byte of register DX. 


DL 


Low-order byte of register DX. 


SP 


Stack pointer (16-bit) 


BP 


Base pointer (16-bit) 


IP 


Instruction Pointer (16-bit) 


Flags 


16-bit register space, in which nine flags reside. 


Dl 


Destination Index register (16-bit) 


SI 


Stack Index register (16-bit) 


CS 


Code Segment register (16-bit) 


DS 


Data Segment register (16-bit) 


ES 


Extra Segment register (16-bit) 


SS 


Stack Segment register (16-bit) 
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Table 6-3. Symbols (Cont'd.) 



8086/8088 
Descriptor 


Meaning 


REG8 


The name or encoding of an 8-bit CPU register location. 


REG16 


The name or encoding of an 16-bit CPU register location. 


LSRC, RSRC 


Refer to operands of an instruction, generally left source and 
right source when two operands are used. The leftmost 
operand is also called the destination operand, and the 
rightmost is called the source operand. 


reg 


A field that specifies REG8 or REG16 in the description of an 
instruction. 


EA 


Effective address (16-bit) 


r/m 


Bits 2, 1, and of the MODRM byte used in accessing 
memory operands. This 3-bit field defines EA, in conjunction 
with the mode and w fields. 


mode 


Bits 7 and 6 of the MODRM byte. This 2-bit field defines the 
addressing mode. 


w 


A 1-bit field in an instruction, identifying byte instructions 
(w=0), and word instructions (w=1) 


d 


A 1-bit field in an instruction, "d" identifies direction, i.e. 
whether a specified register is source or destination. 


(...) 


Parentheses mean the contents of the enclosed register or 
memory location. 


(BX) 


Represents the contents of register BX, which can mean the 
address where an 8-bit operand is located. To be so used in 
an assembler instruction, BX must be enclosed only in 
square brackets. 


((BX)) 


Means this 8-bit operand, the contents of the memory 
location pointed at by the contents of register BX. This nota- 
tion is only descriptive for use in this chapter. It cannot 
appear in source statements. 


(BX) + 1,(BX) 


Means the address (of a 16-bit operand) whose low-order 
8-bits reside in the memory location pointed at by the con- 
tents of register BX and whose high-order 8-bits reside in the 
next sequential memory location, (BX) + 1 . 


((BX) + 1,(BX)) 


Means the 16-bit operand that resides there. 


Concatenation, e.g., 
((DX) + 1:(DX)) 


Means a 16-bit word that is the concatenation of two 8-bit 
bytes, the low-order byte in the memory location pointed at 
by DX and the high-order byte in the next sequential memory 
location. 


addr 


Address (16-bit) of a byte in memory. 


addr-low 


Least significant byte of an address. 


addr-high 


Most significant byte of an address. 


addr + 1: addr 


Addresses of two consecutive bytes in memory, beginning at 
addr. 


data 


Immediate operand (8-bit if w=0; 16-bit if w=1). 


data-low 


Least significant byte of 16-bit data word. 


data-high 


Most significant byte of 16-bit data word. 


disp 


Displacement 


disp-low 


Least significant byte of 16-bit displacement. 


disp-high 


Most significant byte of 16-bit displacement. 


«- 


Assignment 


+ 


Addition 


- 


Subtraction 


* 


Multiplication 


/ 


Division 


% 


Modulo 


& 


And 


| 


Inclusive or 


» 


Exclusive or 
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Table 6-4,. Effective Address Calculation Time 



EA Components 


Clocks* 


Displacement Only 


6 


Base or Index Only (BXBP.SI.DI) 


5 


Displacement 

+ 
Base or Index (BX, BP.SI, Dl) 


9 


Base BP + DI, BX + SI 


7 


+ 
Index BP + SI, BX + DI 


8 


Displacement BP + DI + DISP 
+ BX + SI + DISP 


11 


Base 

+ BP + SI + DISP 
Index BX + DI + DISP 


12 



'Add 2 clocks for segment override 
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Sample 8086/8088 Instruction 



Format 



opcode 



modrm 



data 



data 



a n ik 



♦ * 



■ immediate data (either 8- or 16-bits) 



an offset value (either 8- or 16-bits) 
a mod/rm byte if needed 



the opcode 



Opcode Clocks 



Operation 



(the value (number of clocks (the machine operation) 

of the required) 

opcode 

byte) 



Coding Example 

MNEMONIC 



Operation 

(A description of the machine operation.) 

Flags 

ODITSZAPC 

(shows the effect on the flags) 

Description 

(Describes the use/operation of the instruction.) 
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AAA 



ASCII Adjust for Addition 



Format 



Opcode 



Opcode Clocks 

37 4 



Operation 

adjust AL, flags, AH 



Coding Example 

AAA 



Operation 

if (AL & OFH) > 9 or AF = 1 then do; 

AL-AL + 6 

AH -AH + 1 

CF*-AF-1 
end; 
AL-AL&OFH 



Flags 

ODITSZAPC 
U---UUXUX 

Description 

AAA is used to correct the result of adding two unpacked BCD digits in the AL 
register. After the normal byte addition, AAA tests the auxiliary carry flag (AF), 
which is set by a carry out of the low nibble of AL. If either the AF is set or the low 
nibble of AL is greater than 9, then a carry bit is added to the AH register, and the 
low nibble of AL is increased by 6 to produce the decimal digit. AL is masked to 4 
bits whether an adjustment was performed or not, thus always leaving an unpacked 
BCD result in the low nibble of AL. High nibble data does not affect the corrected 
result of the addition, so ASCII digits can be added correctly by following the AAA 
with an OR AL,30H to restore the result to an ASCII character. The digit carry, in 
AH, is not affected by this restoration. 
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ASCII Adjust for Division 

Format 



Long Opcode 



Opcode Clocks Operation Coding Example 

D5.0A 60 Adjust AL, AH prior to division AAD 

Operation 

AL-AL + (AH*0AH) 
AH^O 

Flags 

ODITSZAPC 
U---XXUXU 

Description 

AAD is used to prepare 2 unpacked BCD digits (least significant in AL, most signifi- 
cant in AH) for a division operation that will yield an unpacked result. This is 
accomplished by multiplying AH by 10 and adding the product to AL. Then AH is 
zeroed, leaving AX with the binary equivalent of the original unpacked 2-digit 
number. 
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ASCII Adjust for Multiplication 



Format 






Long — 


- Opcode 


] 


Opcode 

D4,0A 


Clocks 

83 


Operation 

Adjust AL, AH after 
multiplication 



Coding Example 

AAM 



Operation 

AH - (AL / OAH) 
AL^(ALMODOAH) 



Flags 

ODITSZAPC 
U---XXUXU 

Description 

AAM is used to produce 2 unpacked BCD digits (least significant in AL, most 
significant in AH) after a multiplication of 2 unpacked digits. This is accomplished 
by dividing the binary product in AL by ten. The quotient is left in AH as the most 
significant digit, and the remainder is left in AL as the least significant digit. 
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ASCII Adjust for Subtraction 



Format 



Opcode 



Opcode Clocks 

3F 4 



Operation 

adjust AL, flags, AH 



Coding Example 

AAS 



Operation 



if (AL & OFH) > 9 or AF = 1 then do; 

AL«-AL-6 

AH-AH-1 

CF-AF-1 
end; 
AL-AL&OFH 



Flags 

ODITSZAPC 
U---UUXUX 

Description 

AAS is used to correct the result of subtracting two unpacked BCD digits in the AL 
register. After the normal byte subtraction, AAS tests the auxiliary carry flag (AF), 
which is set by a carry out of the low nibble of AL. If the AF is set or the low nibble 
of AL is greater than 9, then a borrow bit is subtracted from AH, and the low nibble 
of AL is decreased by 6 to produce the proper decimal digit. AL is masked to 4 bits 
whether an adjustment was performed or not, thus always leaving an unpacked 
BCD result in the low nibble of AL. High nibble data does not affect the corrected 
result of the subtraction, so ASCII digits can be subtracted correctly by following 
the AAS with an OR AL,30H to restore the result to an ASCII character. The digit 
borrow, in AH, is not affected by this restoration. 
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ADC 



Integer Add With Carry 



Format 

Memory/Reg + Reg 



Opcode 



Opcode 



ModRM 



Clocks 



12 


3 


12 


9+EA 


13 


3 


13 


9+EA 


10 


16+ EA 


11 


16 + EA 



Z 



Operation 



CF + Reg 8 + Reg8 
Reg8 - CF + Reg8 + Mem8 
Reg16 «-CF + Reg16 + Reg16 
Reg16 - CF + Reg16 + Mem16 
Mem8 - CF + Mem8 + Reg8 
Mem16 - CF + Mem16 + Reg16 



Coding Example 

ADC BL,CL 

ADC BL.BYTESOMETHING 

ADC BX.CX 

ADC BX.WORDSOMETHING 

ADC BYTESOMETHING,BL 

ADC WORDSOMETHING.BX 



Immed to AX/AL 



Opcode 



Opcode 

14 
15 



Data 



Clocks 



Zl 



Operation 

AL*-CF + AL + ImmedS 
AX*-CF + AX + ImmedU 



Coding Example 

ADC AL,5 
ADC AX.400H 



Immed to Memory/Reg 



Opcode 



ModRM* 



'-(Reg field =010) 
Opcode Clocks Operation 



80 


4 


80 


17+EA 


81 


4 


81 


17+EA 


83 


4 


83 


17+EA 



Reg8 — CF + Reg8 + Immed8 
Mem8 — CF + Mem8 + Immed8 
Reg16 «- CF + Reg16 + Immed16 
Mem16 «- CF + Mem16 + Immed16 
Reg16 - CF + Reg16 + Immed8 
Mem16^CF + Mem16 + Immed8 
(Immed8 is sign-extended 
before add in last 2 cases) 



Data 



z:z 



Coding Example 

ADC BL.,32 

ADC BYTESOMETHING.32 

ADC BX,1234H 

ADC WORDSOMETHING,1234H 

ADC BX,32 

ADC WORDSOMETHING,32 



Operation 

LeftOpnd < -CF + LeftOpnd + RightOpnd 

Flags 

0DITSZAPC 
X---XXXXX 



Description 

The sum of two operands and the initial state of the carry flag replaces the left 
operand. 



6-25 



ADD 



ASM86 



Integer Addition 

Format 

Memory/Reg + Reg 



Opcode 


ModRM 






| 




Opcode 


Clocks 


Operation 


Coding Example 


02 


3 


Reg8*-Reg8 + Reg8 


ADD 


BL,CL 


02 


9+EA 


Reg8*-Reg8 + Mem8 


ADD 


BL.BYTESOMETHING 


03 


3 


Reg16«-Reg16 + Reg16 


ADD 


BX,CX 


03 


9 + EA 


Reg16*- Reg16 + Meml6 


ADD 


BX,WORDSOMETHING 


00 


16+EA 


Mem8 *- Mem8 + Reg8 


ADD 


BYTESOMETHING.BL 


01 


16 + EA 


M 


em16 — Mem16 + 


Ret)16 


ADD 


WORDSOMETHING,BX 



Immed to AX/AL 



Opcode 



Data 



code 


Clocks 


Operation 


04 


4 


AL — AL + Immed8 


05 


4 


AX^AX + Immed16 



Coding Example 

ADD AL,5 
ADD AX.400H 



Immed to Memory/Reg 



Opcode 



Opcode 



ModRnV 



*-(Reg field = 000) 
Clocks Operation 



80 


4 


80 


17+EA 


81 


4 


81 


17+EA 


83 


4 


83 


17 + EA 



Reg8 — Reg8 + Immed8 
Mem8 «- Mem8 + ImmedS 
Reg16 *- Reg16 + Immed16 
Mem16-<- Mem16 + Immed16 
Reg16 — Reg16 + Immed8 
Mem16 *- Mem16 + Immed8 
(Immed8 is sign-extended 
before add in last 2 cases) 



Data 



n 



Coding Example 

ADD BL.32 

ADD BYTESOMETHING,32 

ADD BX,1234H 

ADD WORDSOMETHING.1234H 

ADD BX.32 

ADD WORDSOMETHING,32 



Operation 

LeftOpnd - LeftOpnd + RightOpnd 

Flags 

0DITSZAPC 
X---XXXXX 

Description 

The sum of two operands replaces the left operand. 
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AND 



Logical AND 



Format 

Memory/Reg with Reg 



Opcode 



Opcode 



ModRM 



Clocks 



22 


3 


22 


9 + EA 


23 


3 


23 


9+EA 


20 


16 + EA 


21 


16 + EA 



Operation 

Reg8*- Reg8ANDReg8 
Reg8 — Reg8 AND Mem8 
Reg16«-Reg16ANDReg16 
Reg16 - Reg16 AND Mem16 
Mem8 <- Mem8 AND Reg8 
Mem16- Mem16 AND Reg16 



3 



Coding Example 

AND BL.CL 

AND BL.BYTESOMETHING 

AND BX.CX 

AND BX.WORDSOMETHING 

AND BYTESOMETHING,BL 

AND WORDSOMETHING.BX 



Immed to AX/AL 



Opcode 



Opcode 



Data 



Clocks 



n 



Operation 



Coding Example 



24 


4 


AL-ALANDImmed8 


AND AL,4 


25 


4 


AX- AXANDImmed16 


AND AX,400H 



Immed to Memory/Reg 



Opcode 


ModRm 


' | 




Data 






*._ 


(Reg field = 100) 




Opcode 


Clocks 




Operation 


Coding Example 


80 


4 




Reg8 *- Reg8 AND Immed8 


AND BL.3FH 


80 


17+EA 




Mem8 — Mem8 AND Immecl8 


AND BYTESOMETHING.3FH 


81 


4 




Reg16 *- Reg16 AND Immed16 


AND BX.3FFH 


81 


17+EA 




Mem16 *- Mem16 AND Imrned16 


AND WORDSOMETHING,3FFH 


Operation 

















Zl 



LeftOpnd - LeftOpnd and RightOpnd 
OF-CF^0 



Flags 



D I T S Z A P C 
- - - X X U X 



Description 

The result of a bitwise logical AND of the two operands replaces the left operand. 
The carry and overflow flags are cleared. 
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Check Array Against Bounds [iAPX 186] 

For 186 clocks, see Appendix H. 



Format 



Opcode 



ModRM 



Zl 



Opcode Operation 

62 if Reg16< Mem16at EA, or 

Reg16 > Mem16 at EA + 2 then 
INTERRUPT 5 



Coding Example 

BOUND BX,ARRAYFOO. 4 



Operation 

if left-operand (a register) < lower-limit (a word variable at EA) 
or left-operand > upper-limit (at EA + 2) then do; 
INTERRUPT 5; 
end if; 



Flags 

NPLODITSZAPC 



Description 

BOUND is used to ensure that a signed array index is within the limits defined by a 
two-word block of memory. This two word block might typically be found just 
before the array itself and therefore be accessible at a constant offset of -4 from the 
array, simplifying the addressing. The first word of the block at the effective address 
contains the lower limit, and the second word contains the upper limit for the index, 
which is in the register operand of the instruction. The effective address cannot be a 
register operand — that is, the two-word block cannot be in registers. 
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CALL 



Call 

Format 

Within segment or group, IP relative 



Opcode 


DispL 


DispH 



Opcode 

E8 



Clocks 



Operation 

IP-IP + Disp16 
— (SP) — return link 



Coding Example 

CALL NEAFL_LABEI FOO 



Within segment or group, Indirect 



Opcode 



ModRM' 



~Z\ 





*— (Reg field = 010) 


Opcode 


Clocks 


Operation 


FF 


16 


IP*-Reg16 
—(SP)*- return link 


FF 


21 + EA 


IP*- Mem16 

— (SP) — return link 


FF 


21 + EA 


IP*-Mem16 
—(SP)*- return link 


Operation 






if IP-relative the 


;n do; 




IP-IP + Dis 


p16; 




— (SP)*- return link; 




else do; 






IP-(EA); 






— (SP) *- return link; 




end if; 







Coding Example 

CALL SI 

CALL WORDPTR[SI] 

CALL POINTER_TO._FRED 



Flags 



ODITSZAPC 



Description 

There are two types of within-segment or group calls: one that is IP-relative and is 
specified by the use of a NEAR label as the target address, and one in which the 
target address is taken from a register or variable pointer without modification (i.e., 
is NOT IP-relative). In the first case, the 16-bit displacement is relative to the first 
byte of the next instruction. 

The second case is specified when the operand is any (16-bit) general, base, or index 
register — as in CALL AX, CALL BP, or CALL DI, respectively — or when the 
operand is a word-variable, as in CALL WORD PTR [BP] or CALL 
OPEN__ROUTINE[BX] (assuming that OPEN_ROUTINE is declared a word 
array or structure element). When the effective address is a variable, as in the 
preceding two examples, DS is the implied segment register for all EA's not using 
BP. 
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The return link, which is pushed to the TOS during the CALL, is the address of the 
instruction following the CALL. 

Inter-segment or group, Direct 



Opcode 


offset 


offset 


segbase 


segbase 




Opcode Clocks 


Operation 




Coding Example 




9A 28 


CS — segbase 
IP - offset 




CALL FAFL_LABEI FOO 


Operation 








CS «- segbase; 

IP - offset; 

— (SP)«- return link; 








Flags 








ODITSZAPC 













Inter-segment or group, Indirect 



Opcode 



Opcode 

FF 



ModRM* 



*— (Reg field = 011) 

Clocks Operation 



37+EA 



CS — segbase 
IP *- offset 



Coding Example 

CALL DWORD PTR FOO 



Operation 

CS-(EA + 2); 
JP*-(EA); 



Flags 

ODITSZAPC 



Description 

An intersegment or group (long or far) CALL will transfer control by replacing both 
the values in CS and IP. This effectively transfers control to another segment or 
group by changing both the base (paragraph number) and offset values. 
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CBW 



Convert Byte to Word 



Format 



Opcode 



Opcode Clocks 

98 2 



Operation 

convert byte in AL to word 
in AX 



Coding Example 

CBW 



Operation 

if (AL AND 80H) = 80H then do; 

AH^OFFh 
else do; 

AH-0 
end; 



Flags 

ODITSZAPC 



Description 

CBW converts the byte in AL to a word in AX by sign extension of AL through AH. 
No flags are affected. 
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CLC 



ASM86 



Clear Carry Flag 

Format 



Opcode 



Opcode Clocks Operation Coding Example 

F8 2 clear the carry flag CLC 

Operation 

CF-0 

Flags 

ODITSZAPC 

--------o 

Description 

CLC clears the carry flag, CF. No other flags are affected. 
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ASM86 QLQ 

Clear Direction Flag 

Format 



Opcode 


Clocks 


Operation 




Opcode 


Coding Exampl 


FC 


2 


clear direction flag 


CLD 


Operation 









DF-0 

Flags 

ODITSZAPC 

-o------- 

Description 

CLD clears the direction flag, DF. No other flags are affected. 
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CLI 



ASM86 



Clear Interrupt Enable Flag 



Format 



Opcode 


Clocks 


Operation 




Opcode 


Coding Example 


FA 


2 


clear interrupt flag 


CLI 


Operation 









IF — 

Flags 

ODITSZAPC 

Description 

CLI clears the interrupt enable flag, IF. No other flags are affected. 
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CMC 



Complement Carry Flag 



Format 



Opcode 



Opcode Clocks 

F5 2 



Operation 

complement carry flag 



Coding Example 

CMC 



Operation 

if CF = 1 then do; 

CF^O 
else do; 

CF*-1 
end; 



Flags 

ODITSZAPC 

--------x 



Description 

CMC complements the carry flag, CF. No other flags are affected. 



6-35 



CMP 



ASM86 



Compare Two Operands 

Format 

Memory/Reg with Reg 



Opcode 


ModRM 






I 




Opcode 


Clocks 


Operation 


Coding Example 


3A 


3 


flags*- Reg8-Reg8 




CMP BL,CL 


3A 


9 + EA 


flags — Reg8-Mem8 




CMP BL.BYTESOMETHING 


3B 


3 


flags -Reg16-Regl6 




CMP BX.CX 


3B 


9+EA 


flags -Reg16-Mem16 




CMP BX.WORDSOMETHING 


38 


9 + EA 


flags *- Mem8- Reg8 




CMP BYTESOMETHING.BL 


39 


9 + EA 


flags -Mem16-Reg16 




CMP WORDSOMETHING.BX 



Immed to AX/AL 



Opcode 



Data 



Z2 



)code 


Clocks 


Operation 


Coding Exampl 


3C 


4 


flags — AL-lmmed8 


CMP AL,5 


3D 


4 


flags — AX-lmmed16 


CMP AX.400H 



Immed to Memory/Reg 



Opcode 



ModRM' 



*— (Reg field = 111) 



Data 



ZZI 



»code 


Clocks 


Operation 


Coding Example 


80 


4 


flags — Reg8 - Immed8 


CMP 


BL.32 


80 


10 + EA 


flags — Mem8 - Immed8 


CMP 


BYTESOMETHING,32 


81 


4 


flags — Reg16- Immed16 


CMP 


BX,1234H 


81 


10 + EA 


flags — Mem16-lmmed16 


CMP 


WORDSOMETHING,1234H 


83 


4 


flags — Reg16 - Immed8 


CMP 


BX,32 


83 


10 + EA 


flags — Mem16-lmmed8 
(Immed 8 is sign-extended 
before sub in last 2 cases) 


CMP 


W0RDS0METHING.32 



Operation 

flags - LeftOpnd - RightOpnd 

Flags 

ODITSZAPC 
X---XXXXX 

Description 

The flags are set by the subtraction of the right operand from the left operand. 
Neither operand is modified. A table of signed and unsigned comparisons supported 
by conditional jumps is provided under the 'Jcond' heading of this chapter. 
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CWD 



Convert Word to Doubleword 



Format 



Opcode 






Opcode 


Clocks Operation 


Coding Example 


99 5 convert word in AX to 


CWD 


doubleword in DX:AX 




Operation 




if (AX AND 8000H) = 8000H then do; 




DX-OFFFFH 




else do; 




DX-0 




end; 




Flags 




ODITSZAPC 




Description 







CWD converts the word in AX to a doubleword in DX:AX by sign extension of AX 
through DX. No flags are affected. 



6-37 



DAA 
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Decimal Adjust for Addition 



Format 



Opcode 



Opcode Clocks 

27 4 



Operation 

adjust AL, flags, AH 



Coding Example 

DAA 



Operation 

if (AL & OFH) > 9 or AF = 1 then do; 

AL-AL + 6 

AF«-1 
end; 
if AL>9ForCF = 1 then do; 

AL-AL + 60H 

CF-1 
end; 



Flags 

ODITSZAPC 
U---XXXXX 

Description 

DAA is used to correct the result of adding two bytes, each of which contains two 
packed BCD digits, in order to produce a packed decimal result. After the normal 
byte addition in AL, DAA tests the auxiliary carry flag (AF), which is set by a carry 
out of the low nibble of AL. If either the AF is set or the low nibble of AL is greater 
than 9, then the low nibble of AL is increased by 6 to produce the correct decimal 
digit, and the high nibble of AL is incremented, effecting the digit carry. 

Whether this first adjustment is made or not, a second adjustment is made if AL is 
greater than 9FH or if the CF is set, indicating a carry out of the high digit. In this 
case, 60H is added to AL and the CF is set. 
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DAS 



Decimal Adjust for Subtraction 



Format 



Opcode 



Opcode 

2F 



Clocks 



Operation 

adjust AL, flags, AH 



Coding Example 

DAS 



Operation 

if (AL & OFH) > 9 or AF : = 1 then do; 

AL-AL-6 

AF-1 
end; 
if AL>9ForCF = 1 then do; 

AL-AL-60H 

CF*-1 
end; 



Flags 

ODITSZAPC 
U---XXXXX 

Description 

DAS is used to correct the result of subtracting two bytes, each of which contains 
two packed BCD digits, in order to produce a packed decimal result. After the nor- 
mal byte subtraction in AL, DAS tests the auxiliary carry flag (AF), which is set by a 
carry out of the low nibble of AL. If either the AF is set or the low nibble of AL is 
greater than 9, then the low nibble of AL is reduced by 6 to produce the correct 
decimal digit. 

Whether this first adjustment is made or not, a second adjustment is made if AL is 
greater than 9FH or the CF is set, indicating a borrow out of the high digit. In this 
case, 60H is subtracted from AL and the CF is set. 
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DEC 



ASM86 



Decrement by 1 

Format 

Word Register 



Opcode + reg 



Opcode 

48 + reg 



Clocks 

2 



Operation 

Reg16-Reg16-1 



Coding Example 

DEC BX 



Memory/Byte Register 



Opcode 



ModRM' 



*— (Reg field = 001) 



Flags 

ODITSZAPC 
X - - - X X X X - 

Description 

The operand is decremented by 1 , 



I] 



Opcode 




Clocks 


Operation 


Coding Example 


FE 




3 


Reg8- Reg8-1 


DEC BL 


FE 




15+EA 


Mem8*- Mem8-1 


DEC BYTESOMETHING 


FF 




15 + EA 


Mem16-Mem16-1 


DEC WORDSOMETHING 


Operation 








Operand — 


Operand -1 
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DIV 



Unsigned Division 

Format 

Memory/Reg with AX or DX:AX 



Opcode 



ModRM* 



ZZI 



k — (Reg field = 110) 



Opcode 



Clocks 



Operation 



Coding Example 



F6 


80-90 


AH,AL-AX/Reg8 


DIV 


BL 


F6 


(86-96) + EA 


AH.AL-AX/ Mem8 


DIV 


BYTESOMETHING 


F7 


144-162 


DX,AX-DX:AX/ Reg16 


DIV 


BX 


F7 


(150-168)+ EA 


DX,AX-DX:AX/Mem16 


DIV 


WORDSOMETHING 


Operation 











if byte-operation then do; 
if AX / divisor > OFFH then INT 0; 
else do; 
AL"- AX / divisor 
AH -AX MOD divisor 
end if; 
else do; 

if DX:AX / divisor > 0FFFFH then INT 
else do; 
AX — DX:AX / divisor /* unsigned division */ 
DX«-DX:AX MOD divisor /* unsigned modulo*/ 
end if; 
end if; 



/* unsigned division */ 
/* unsigned modulo */ 

/* word-operation */ 



Flags 

ODITSZAPC 
U---UUUUU 

Description 

Depending on the opcode, either a word in AX is divided by a byte found in a 
register or memory location, or a doubleword in DX:AX is divided by a word 
register or memory location. A doubleword dividend is stored with its high word in 
DX and low word in AX, and the results are: DX gets the unsigned modulo, and AX 
gets the unsigned quotient. For a word dividend (byte divisor), the dividend is in AX 
and the results are: AH gets the unsigned modulo, and AL gets the unsigned quo- 
tient. In either case, if the result is too big to fit in the designated register (AX or AL) 
then an interrupt of type is performed to allow the overflow to be handled. 
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ENTER 



ASM86 



High Level Procedure Entry [iAPX 186] 

For 186 clocks, see Appendix H. 
Format 



Opcode 


DataL 


DataH 


Level 



Opcode Operation 

C8 build new stack frame 

Operation 



Coding Example 

ENTER NUMDYNS,LEXLVL 



right-operand = display level 

left-operand = number of bytes of dynamic storage needed by the routine 

-(SP)^BP; 

temp*-SP; 

if display level >0then 

repeat level -1 times; 
-(SP)--(BP); 

end repeat; 

— (SP)-temp; 
end if; 
BP-^temp; 
SP *- SP - number of dynamics; 

Flags 

NPLODITSZAPC 



Description 

ENTER is used to create* the stack frame required by most block-structured high- 
level languages. The first parameter specifies how many bytes of dynamic storage is 
to be allocated on the stack for the routine being entered, while the second cor- 
responds to the lexical nesting level of the routine and determines how many stack 
frame pointers are copied into the new stack frame from the preceding frame. This 
list of pointers is also known as the DISPLAY. BP is used as the current stack frame 
pointer. ENTER first pushes BP and saves the address of the BP-save for later use. 
If the lexical level is greater than 0, then the list of outer frame pointers from the 
preceding frame is copied to the new frame, the stack is marked with the temporary 
holding the address of the top of this list, and BP is set to the current value of SP. 
Then the dynamics are allocated by subtracting the number of bytes of dynamics 
from SP. 
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ESC 



Escape 



Format 



Opcode + i 


ModRM 




| 


Opcode 


Clocks 


Operation 


Coding Example 


D8+i 
D8 + i 


8 + EA 
2 


data bus *-(EA) 
data bus «-(EA) 


ESC 6, ARRAY 
ESC 20,AL 


Operation 











if mod * 11 then data bus «- (EA) 
if mod = 11 then no operation 



Flags 

ODITSZAPC 



Description 

The ESC instruction provides a mechanism by which other processors may receive 
their instructions from the 8086 instruction stream and make use of the 8086 
addressing modes. The 8086 processor does no operation for the ESC instruction 
other than to access a memory operand and place it on the bus. 
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HLT 



ASM86 



Halt 



Format 

Opcode 
Opcode 

F4 



Clocks 

2 



Operation 

halt operation 



Coding Example 

HLT 



Operation 

cease operation; 

Flags 

ODITSZAPC 



Description 

The HLT instruction causes the 8086/8088 processor to enter its halt state. The halt 
state is cleared by an enable interrupt or reset. 
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IDIV 



Signed Division 

Format 

Memory/Reg with AX or DX:AX 



Opcode 



ModRM' 



3 



"—(Reg field =111) 



Opcode 



Clocks 



Operation 



Coding Example 



F6 


101-112 


AH.AL-AX / Reg8 


IDIV 


BL 


F6 


(107-118) + EA 


AH,AL*-AX / Mem8 


IDIV 


BYTESOMETHING 


F7 


165-184 


DX,AX-DX:AX / Reg16 


IDIV 


BX 


F7 


(171-190) + EA 


DX,AX*-DX:AX / Mem16 


IDIV 


WORDSOMETHING 



Operation 



if byte-operation then do; 
if AX / divisor > 7FH or AX / divisor 
else do; 
AL — AX / divisor 
AH- AX MOD divisor 
end if; 
else do; 
if DX:AX / divisor > 7FFFH or DX:AX / divisor 
else do; 
AX — DX:AX / divisor /* signed division */ 
DX-DX:AX MOD divisor /* signed modulo */ 
end if; 
end if; 



80H then INTO; 

/* signed division */ 
/* signed modulo */ 

/* word-operation */ 

8000H then INTO; 



Flags 

ODITSZAPC 
U---UUUUU 

Description 

Depending on the opcode, either a word in AX is divided by a byte in a register or 
memory location, or a dword in DX:AX is divided by a word register or memory 
location. A dword dividend is stored with its high word in DX and low word in AX, 
and the results are: DX gets the signed modulo, and AX gets the signed quotient. 
For a word dividend (byte divisor) the dividend is in AX, and the results are: AH 
gets the signed modulo, and AL gets the signed quotient. In either case, if the result 
is too big to fit in the designated register (AX or AL) then an interrupt of type is 
performed to allow the overflow to be handled. 
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IMUL 



ASM86 



Signed Multiplication 

For 186 clocks, see Appendix H. 

Format 

Memory/Reg with AL or AX 



Opcode 



ModRM* 



Zl 



-(Reg field = 101; 



Opcode 

F6 
F6 
F7 
F7 



Clocks 



Operation 



80-98 AX-AL*Reg8 

(86-104) + EA AX-AL*Mem8 

128-154 DX:AX -AX* Reg16 

(134-160)+ EA DX:AX-AX* Mem16 



Coding Example 

IMUL BL 

IMUL BYTESOMETHING 

IMUL BX 

IMUL WORDSOMETHING 



Mem/Reg * Immediate to Reg [iAPX 186] 



Opcode 



ModRM 



Opcode 



Operation 



6B 


Reg 16 


6B 


Reg 16 


6B 


Reg 16 


69 


Reg 16 


69 


Reg 16 


69 


Reg 16 



Reg 16 * Immed 8 
Reg 16 * Immed 8 
Mem 16 * Immed 8 
Reg 16* Immed 16 
Reg 16* Immed 16 
Mem 16 * Immed 16 







Data 




Coding Example 


IMUL 


BX.SI.5 


IMUL 


BX,5 ;product^BX 


IMUL 


BX,WORDSMTHING,5 


IMUL 


BX,SI,400H 


IMUL 


BX.400H ;product-BX 




IMUL 


BX,WORDSMTHING,400H 



H 



/* byte operation, word result */ 
OF-0; 



Operation 

if byte-operation then do; 

AX *- AL * (Mem8 or Reg8); 

if AH is a sign extension of AL then CY 

elseCY-OF-1; 
else if word-operation then do; /* word-operation, dword result * 

DX:AX <- AX * (Mem16 or Reg16); 

if DX is a sign extension of AX then CY «- OF — 0; 

elseCY-OF-1; 
else do; /* immed-operation, word result 

Reg16 - Immed16 * (Mem16 or Reg16); 

if product fits in destination register then CY *- OF — 0; 

elseCY*-OF-1; 
end if; 



Flags 



ODITSZAPC 
X---UUUUX 
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ASM86 IMUL 

Description 

There are two types of integer (signed) multiplication in the ASM86, distinguishable 
by the types of operands and the precision of the result: 

1 . Multiply a byte memory or register operand by a byte in AL, producing a word 
result in AX (called 'byte-operation, word result' above). 

2. Multiply a word memory or register operand by a word in AX, producing a 
dword result in DX:AX (called 'word-operation, dword result' above). 

There is a third type of integer (signed) multiplication in the iAPX 186, 
distinguishable by the types of operands and the precision of the result: 

3. Multiply a word memory or register operand by a word (or byte, which will be 
sign-extended to a word) of immediate data, producing a word result in a regis- 
ter. This instruction uses the full capability of the MODRM byte; therefore the 
destination need not be the same register as contained the multiplicand. For 
example, IMUL BX,SI,5 will multiply the contents of the SI register by 5 and 
leave the (word) result in BX (called 'immed-operation, word result' above). 
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IN 



ASM86 



Input Byte, Word 



Format 








Fixed port 








Opcode 


Port 




Opcode 


Clocks 


Operation 


E4 


10 


AL - Port8 


E5 


10 


AX - Port8 


Variable port 


Clocks 




Opcode 




Opcode 


Operation 


EC 


8 


AL - Port16(in DX) 


ED 


8 


AX - Port16(in DX) 


Operation 









Coding Example 

IN AL.BYTEPORTNUMBER 
IN AL.BYTEPORTNUMBER 



Coding Example 

IN AL.DX 
IN AX.DX 



if fixed-port then 

portnumber in instruction; 

< portnumber < OFFH; 
else 

portnumber in DX; 

< portnumber < OFFFFH; 
end if; 

if byte-input then AL •«- ioport[portnumber] 
else AX *- ioport[portnumber]; 



Flags 



ODITSZAPC 



Description 

IN transfers a byte or word from the specified input port to AL or AX. Use of the 
fixed port format allows access to ports through FF, and encodes the port number 
in the instruction. To use the variable port format you load the DX register with a 16 
bit port number and then code the mnemonic 'DX' in place of a constant port 
number. This format allows access to 64k ports. 
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INC 



Increment By 1 

Format 

Word Register 



Opcode + reg 



Opcode 

40 + reg 



Clocks 

2 



Operation 

Reg16~Reg16 + 1 



Coding Example 

INC BX 



Memory/Byte Register 



Opcode 



ModRM* 



-(Reg field = 000) 



3 



Opcode 




Clocks 


Operation 


Coding Example 


FE 




3 


Reg8- Reg8 + 1 


INC BL 


FE 




15+ EA 


Mem8 — Mem8 + 1 


INC BYTESOMETHING 


FF 




15+ EA 


Mem16*-Mem16 + 1 


INC WORDSOMETHING 


Operation 








Operand «- 


Operand + 1 







Flags 

ODITSZAPC 
X---XXXX- 

Description 

The operand is incremented by 1 . 
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INT 
INTO 



ASM86 



Interrupt 



Format 



Opcode 


type 


Operation 




Opcode 


Clocks 


Coding Example 


cc 


52 


Interrupt3 


INT 3 


CD 


51 


Interrupt 'type' 


INT 5 


CE 


53 or 4 


Interrupt 4 if FLAGS. OF = 1, 
else NOP 


INTO 


Operation 








SP-SP-2 








— (SP)- FLAGS 








IF — 








TF-0 








SP-SP-2 








-(SP)-CS 








CS-TYPEM -f 


- 2 






SP-SP-2 








— (SP)-IP 








IP -TYPE* 4 









Flags 



D I T S Z A P C 

--00 



Description 

INT pushes the flag registers (as in PUSHF), clears the TF and IF flags, and 
transfers control with an indirect call through any one of the 256 vector elements. 
The one-byte form of this instruction generates a type 3 interrupt. 

INTO pushes the flag registers (as in PUSHF), clears the TF and IF flags, and 
transfers control with an indirect call through vector element 4 (location 10H) if the 
OF flag is set (trap on overflow). If the OF flag is clear, no operation takes place. 
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IRET 



Return from Interrupt 



Format 



Opcode 


Clocks 


Operation 




Opcode 


Coding Example 


CF 


24 


Return from interrupt 


IRET 


Operation 








IP«-(SP) + + 








SP-SP + 2 








CS-(SP) + + 








SP-SP + 2 








FLAGS *-(SP) + + 






SP-SP + 2 









Flags 

ODITSZAPC 
XXXXXXXXX 

Description 

IRET returns control to an interrupted routine by transferring control to the return 
address saved by a previous interrupt operation and restoring the saved flag registers 
(asinPOPF). 
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Jcond 



ASM86 



Jump on Condition 



Operation 

if condition is true then do; 
sign-extend displacement to 16 bits; 
IP *- IP + sign-extended displacement; 
end if; 



Format 



Opcode 


Disp 




Codin< 




Opcode Clocks 


Operation 


j Example 


77 


6 or 4 


jump if above 


JA 


TARGETLABEL (CF OR ZF) = 


73 


6 or 4 


jump if above or equal 


JAE 


TARGETLABELCF = 


72 


6 or 4 


jump if below 


JB 


TARGETLABEL CF = 1 


76 


6 or 4 


jump if below or equal 


JBE 


TARGETLABEL (CF OR ZF)=1 


72 


6 or 4 


jump if carry set 


JC 


TARGETLABEL CF=1 


74 


6 or 4 


jump if equal 


JE 


TARGETLABEL ZF=1 


7F 


6 or 4 


jump if greater 


JG 


TARGETLABEL ((SF XOR OF) OR 
ZF) = 


7D 


6 or 4 


jump if greater or equal 


JGE 


TARGETLABEL (SF XOR OF) = 


7C 


6 or 4 


jump if less 


JL 


TARGETLABEL (SF XOR OF)=1 


7E 


6 or 4 


jump if less or equal 


JLE 


TARGETLABEL ((SF XOR OF) OR 
ZF)=1 


76 


6 or 4 


jump if not above 


JNA 


TARGETLABEL (CF OR ZF)=1 


72 


6 or 4 


jump if neither above nor equal 


JNAE 


TARGETLABEL CF = 1 


73 


6 or 4 


jump if not below 


JNB 


TARGETLABEL CF = 


77 


6 or 4 


jump if neither below nor equal 


JNBE 


TARGETLABEL (CF OR ZF) = 


73 


6 or 4 


jump if no carry 


JNC 


TARGETLABEL CF = 


75 


6 or 4 


jump if not equal 


JNE 


TARGETLABEL ZF=0 


7E 


6 or 4 


jump if not greater 


JNG 


TARGETLABEL ((SF XOR OF) OR 
ZF)=1 


7C 


6 or 4 


jump if neither greater nor 
equal 


JNGE 


TARGETLABEL (SF XOR OF) = 1 


7D 


6 or 4 


jump if not less 


JNL 


TARGETLABEL (SF XOR OF) = 


7F 


6 or 4 


jump if neither less nor equal 


JNLE 


TARGETLABEL ((SF XOR OF) OR 
ZF) = 


71 


6 or 4 


jump if no overflow 


JNO 


TARGETLABEL OF = 


7B 


6 or 4 


jump if no parity 


JNP 


TARGETLABEL PF = 


79 


6 or 4 


jump if positive 


JNS 


TARGETLABEL SF=0 


75 


6 or 4 


jump if not zero 


JNZ 


TARGETLABEL ZF=0 


70 


6 or 4 


jump if overflow 


JO 


TARGETLABEL OF = 1 


7A 


6 or 4 


jump if parity 


JP 


TARGETLABEL PF=1 


7A 


6 or 4 


jump if parity even 


JPE 


TARGETLABEL PF=1 


7B 


6 or 4 


jump if parity odd 


JPO 


TARGETLABEL PF = 


78 


6 or 4 


jump if sign 


JS 


TARGETLABEL SF=1 


74 


6 


Dr4 


jump if zero 


JZ 


TARGETLABEL ZF=1 



E3 1 8 or 6 jump if CX is zero (does not 

test flags) 



JCXZ TARGETLABEL 



Flags 

ODITSZAPC 
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Jcond 



Description 

Conditional jumps (except for JCXZ, explained below) test the flags, which 
presumably have been set in some meaningful way by a previous instruction. 
Because there are, in many instances, several meaningful and useful ways to inter- 
pret a particular state of the flags, ASM86 allows different mnemonics for each 
interpretation to resolve to the same op-code, This means that some op-codes are, in 
effect, synonyms for others. As an example, consider that a programmer who has 
just compared a character to another in AL might wish to jump if the two were equal 
(JE), while another who had just ANDed AX with a bit field mask would prefer to 
consider only whether the result was zero or not (he would use JZ, a synonym for 
JE). 

JCXZ differs from the other conditional jumps in that it actually tests the contents 
of the CX register for zero, rather than interrogating the flags. This instruction is 
useful following a conditionally repeated string operation (REPE SCASB for exam- 
ple) or conditional loop instruction (such as LOOPNE TARGETLABEL), both of 
which may terminate for either of two reasons. These instructions implicitly use a 
limiting count in the CX register, and looping (or repeating) ends either when the 
CX register goes to zero or when the condition specified in the instruction (flags 
indicating equals in both of the above cases) occurs. JCXZ is useful when the two 
terminations must be handled differently. 

In every case, if the condition specified in the conditional jump is true, the signed 
displacement byte is sign extended to a word and added to the IP, which has been 
updated to point to the first byte of the next instruction. This limits the range of the 
conditional jump to 127(decimal) bytes beyond and 126 bytes before the instruction 
(remember, the IP was incremented by 2 to point to the next instruction before the 
displacement was added). 
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JMP 



ASM86 



Jump 

Format 

Within segment or group, IP relative 



Opcode 


DispL 


DispH | 






Opcode 


Clocks 


Operation 


Coding Example 


E9 


15 


IP-IP + Disp16 




JMP NEAR„LABEI FOO 


EB 


15 


IP*- IP + Disp8 
(Disp8 sign-extend 


ed) 


JMP SHORT NR„LAB„FOO 



Within segment or group, Indirect 



Opcode 



Opcode 



ModRM' 



*— (Reg field = 100) 
Clocks Operation 



Zl 



Coding Example 



FF 


11 


IP-Reg16 


FF 


18+EA 


IP*-Mem16 


FF 


18 + EA 


IP*-Mem16 


Operation 






if IP-relative ther 


i do; 




if short then s 


gn-extend D 


isp8toDisp16 


IP-IP + Disp16; 




else do; 






IP-(EA); 






end if; 






Flags 






D I T S Z 


A P C 




Description 







JMP SI 

JMP WORD PTR [SI] 

JMP POINTER_TO_FRED 



There are two types of within-segment jumps: one which is IP-relative and is 
specified by the use of a NEAR label as the target address; and one in which the 
target address is taken from a register or variable pointer without modification (i.e. 
is NOT IP-relative). In the first case, the displacement — which is relative to the first 
byte of the next instruction— may be either a full word or a byte which will be sign- 
extended to a word. 

The second case is specified when the operand is any (16-bit) general, base, or index 
register — as in JMP AX, JMP BP, or JMP DI, respectively— or when the operand is 
a word-variable, as in JMP WORD PTR [BP], or JMP CS:CASE_TABLE[BX] 

(assuming that CASE TABLE was defined as an array of word pointers). When 

the effective address is a variable, as in the preceding two examples, DS is the 
implied segment register for all EA's not using BP. Note especially the difference 
between JMP BX and JMP [BX]. In the first jump the new IP is taken from a 
register, while in the second it comes from a word variable which is pointed at by the 
register. 
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JMP 



Inter-segment or group, Direct 



Opcode 


offset 


offset 


segbase 


segbase 




Opcode 


Clocks 


Operation 




Coding Example 




EA 


15 


OS *- segbase 




JMP FAR_LABEL_FOO 






IP 


— offset 









Operation 

CS "-segbase 
IP - offset 



Flags 



D I T S Z A P C 



Inter-segment or group, Indirect 



Opcode ModRM 



z\ 



*— (Reg field = 101) 



Opcode Clocks 

FF 24 + EA 



Operation 

CS *- segbase 
IP - offset 



Coding Example 

JMP CASE_TABLE[BX] 



Operation 

CS *- EA. segbase; 
IP *- EA. offset; 



Flags 

D I T S Z A P C 



Description 

The long jumps transfer control using both an offset and paragraph number 
(segbase), which may be either included in the instruction itself or found in a 
DWORD variable. 
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LAHF 



ASM86 



Load AH From Flags 



Format 



Opcode 



Opcode 


Clocks 


Operation 


Coding Example 


9F 


4 


copy low byte of flags word to 
AH 


LAHF 


Operation 









AH-SF:ZF:X:AF:X:PF:X:CF 
/* 'x' indicates non-specified bit value */ 



Flags 



ODITSZAPC 



Description 

The Sign, Zero, Auxiliary carry, Parity, and Carry Flags are transferred to AH in 
the following format: 

SF goestoAHbit7 

ZF goestoAHbit6 

AF goes to AH bit4 

PF goestoAHbit2 

CF goestoAHbitO 
The remaining bits are indeterminate. 
No flags are altered. 
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LDS/LES 



Load Pointer to DS/ES and Register 



Format 



Opcode 


ModRM 


| 




Opcode 


Clocks 


Operation 


C4 


16+EA 


dword pointer at EA goes 
to regl 6 (1 st word) and ES 
(2nd word) 


C5 


16+EA 


dword pointer at EA goes 
to reg16 (1st word) and DS 






(2nd word) 





Zl 



Coding Example 

LES BX.DWORDPOINTER 

LDS BX,DWORDPOINTER 



Operation 

Regie*- Mem16@ EA /* offset part of Virtual Address DWord */ 

DS(orES)^Mem16@ EA + 2 /* selector part of Virtual Address DWord */ 



Flags 

ODITSZAPC 



Description 

The double word in the memory location designated by the effective address and 3 
successive bytes is treated as two word operands. The first of these in EA:EA+1 is 
the offset part of the pointer and is loaded into the designated word-register. The 
second word, at EA+2:EA+3, is the paragraph number (segment base) of the 
address, and is loaded into the DS or ES register. 
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LEA 
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Load Effective Address 



Format 



Opcode 



ModRM 



Zl 



Opcode Clocks 

8D 2 + EA 



Operation 

Reg16«-EA 



Coding Example 

LEA BX.SOMEVARIABLE [SI] 



Operation 

if EA = register then UDtrap; 
elseRegie-offse^EA) 



Flags 

ODITSZAPC 



Description 

The effective address of the memory operand is put in the specified register. You 
should use this instruction only if EA requires run time calculation, i.e., has indexing 
with index or base register. Otherwise, you should use MOV reg, OFFSET variable. 
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LEAVE 



High Level Procedure Exit [iAPX 186] 

For 186 clocks, see Appendix H. 
Format 



Opcode 






Opcode 

C9 


Operation 

release current stack frame 
and return to prior frame. 


Coding Example 

LEAVE 



Operation 

SP *- BP; /* burn off dynamics and display */ 

BP <- (SP) + + ; / * recover old frame pointer * / 



Flags 



NPLODITSZAPC 



Description 

LEAVE is the complementary operation to ENTER, and reverses the effects of that 
instruction. By copying BP to SP, LEAVE releases all the stack space used by a 
routine for its dynamics and display. The old frame pointer is now popped into BP, 
restoring the caller's frame, and a subsequent RET xx instruction will follow the 
back-link and remove any arguments pushed on the stack for the exiting routine. 
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LOCK 
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Assert Bus Lock 



Format 



Opcode 






Opcode 


Clocks 


Operation 


FO 2 


assert the bus lock 




next instruction 


Operation 




None. 




Flags 




ODITSZAPC 




Description 







Coding Example 

LOCK XCHG AX, SEMAPHORE 



A special one-byte lock prefix may precede any instruction. It causes the processor 
to assert its bus-lock signal for the duration of the operation caused by the instruc- 
tion. In multiple processor systems with shared resources it is necessary to provide 
mechanisms to enforce controlled access to those resources. Such mechanisms, while 
generally provided through software operating systems, require hardware 
assistance. A sufficient mechanism for accomplishing this is a, locked exchange (also 
known as test-and-set-lock). 

It is assumed that external hardware, upon receipt of that signal, will prohibit bus 
access for other bus masters during the period of its assertion. 

The instruction most useful in this context is an exchange register with memory. A 
simple software lock may be implemented with the following code sequence: 



Check: MOV 
LOCK XCHG 
TEST 
JNZ 



AL,1 ;set AL to 1 (implies Locked) 

Sema,AL ;test and set Lock 

AL, AL ;set flags based on AL 

Check ;retry if Lock already set 



MOV 



Sema,0 ; clear the lock when done 



The LOCK prefix may be combined with the segment override and/or REP prefixes, 
although the latter has certain problems. (See REP.) 
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LOOP 
LOOPE 

LOOPNE 
LOOPZ 

LOOPNZ 



Loop Control 

Format 



Opcode 


Disp 



Opcode 


Clocks 


Operation 


E1 


18 or 6 


dec CX; loop if equal and CX 
notO 


EO 


19 or 5 


dec CX; loop if not equal and 
CX not 


E1 


18or6 


dec CX; loop if zero and CX 
notO 


EO 


19or5 


dec CX; loop if not zero and CX 
notO 


E2 


17 or 5 


dec CX; loop if CX not 



Coding Example 

LOOPE TARGETLABEL 
LOOPNE TARGETLABEL 
LOOPZ TARGETLABEL 
LOOPNZ TARGETLABEL 
LOOP TARGETLABEL 



Operation 

CX - CX - 1 ; 

if (condition is true) and (CX <> 0) then do; 

sign-extend displacement to 16 bits; 

IP *- IP + sign-extended displacement; 
end if; 



Flags 

ODITSZAPC 



Description 

The LOOP instructions are intended to provide iteration control and combine loop 
index management with conditional branching. To use the LOOP instruction you 
load an unsigned iteration count into CX, then code the LOOP at the end of a series 
of instructions to be iterated. Each time LOOP is executed the CX register is 
decremented and a conditional branch to the top of the loop is performed. The five 
variants of the instruction (LOOP, LOOPE, LOOPZ, LOOPNE, and LOOPNZ) 
allow branching on three sets of conditions, since two pairs of variants are 
synonymous. Conditions for branching are: 

LOOP branches if CX non-zero after decrementing; 

LOOPZ, LOOPE branch if CX non-zero and ZF = 1 ; 

LOOPNZ, LOOPNE branch if CX non-zero and ZF = 0. 

In every case, if the condition specified in the conditional loop is true, the signed 
displacement byte is sign extended to a word and added to the IP, which has been 
updated to point to the first byte of the next instruction. This limits the range of the 
conditional loop to 127 (decimal) bytes beyond and 126 bytes before the instruction 
(remember, the IP was incremented by 2 to point to the next instruction before the 
displacement was added). 
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Move Data 



Format 

Memory/Reg to or from Reg 



Opcode 



Opcode 



ModRM 



Clocks 



Operation 



Zl 



Coding Example 



88 


9 + EA 


Mem8*-Reg8 


88 


2 


Reg8^-Reg8 


89 


9 + EA 


Mem16*-Reg16 


89 


2 


Reg16-Reg16 


8A 


8+EA 


Reg8*- Mem8 


8B 


8 + EA 


Reg16~-Mem16 



MOV BYTESOMETHING.AL 

MOV BL.AL 

MOV WORDSOMETHING.AX 

MOV BX.AX 

MOV AL.BYTESOMETHING 

MOV AX,WORDSOMETHING 



Direct-Addressed Memory to or from AX/AL 



Opcode 


AddrL 


AddrH 



Opcode 



Clocks 



Operation 



Coding Example 



AO 


10 


AL-<-Mem8 


A1 


10 


AX-Mem16 


A2 


10 


Mem8- AL 


A3 


10 


Mem16*-AX 


Immed to Reg 






Opcode 


Data 





Opcode 



Clocks 






Operation 



MOV AL,BYTESOMETHING 

MOV AX.WORDSOMETHING 

MOV BYTESOMETHING.AL 

MOV AX.WORDSOMETHING 



Coding Example 



BO + reg 
B8+reg 



Reg 8 — Immed8 
Reg16«-lmmed16 



MOV CL,5 
MOV SI.400H 



Immed to Memory/Reg 



Opcode 



ModRM' 



*-(Reg field = 000) 



Data 



Zl 



)code 


Clocks 


Operation 


Coding Example 


C6 


4 


Reg8 — Immed8 


MOV BL.32 


C6 


10+EA 


MemS*- Immed8 


MOV BYTESOMETHING,32 


C7 


4 


Regie-^lmmedie 


MOV BX.1234H 


C7 


10 + EA 


Mem16 — Immed16 


MOV WORDSOMETHING.1234H 



Memory/Reg to or from SReg 



Opcode 



ModRM' 



Z 



-(Reg field = SReg) 
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MOV 



Opcode 

8C 
8C 
8E 
8E 



Clocks 



Operation 



9 + EA 

2 
8+EA 

2 


Mem16*-SReg 
Reg16-SReg 
SReg* — Mem16 
SReg* - Regl6 




*CS not allowed 



Coding Example 

MOV WORDSOMETHING,DS 

MOV AX,DS 

MOV DS.WORDSOMETHING 

MOV DS,AX 



Operation 

LeftOpnd - RightOpnd 

Flags 

ODITSZAPC 

Description 

The right operand (source) is copied to the left operand (destination). The right 
operand is not modified. No flags are affected. 
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Unsigned Multiplication 

Format 

Memory/Reg with AL or AX 



Opcode 



ModRM* 



3 



*— (Reg field = 100) 



Opcode 



Clocks 



Operation 



Coding Example 



F6 70-77 AX - AL * 

F6 (76-83) + EA AX «- AL * Mem8 

F7 118-133 DX:AX-AX* Reg16 

F7 (124-139) + EA DX:AX - AX * Mem16 



MUL BL 

MUL BYTESOMETHING 

MUL BX 

MUL WORDSOMETHING 



Operation 



if byte-operation then do; 

AX — AL * (Mem8 or Reg8); 

if AH = 0thenCY-OF«-0; 

elseCY-OF-1; 
else if word-operation then do; 

DX:AX *- AX * (Mem16 or Reg16); 

if DX = 0thenCY-OF^0; 

elseCY-OF-1; 
end if; 



/* byte operation, word result */ 



/* word-operation, dword result*/ 



Flags 

ODITSZAPC 
X---UUUUX 

Description 

There are two types of unsigned multiplication in the 8086/8088, distinguishable by 
the types of operands and the precision of the result: 

1 . Multiply a byte memory or register operand by a byte in AL, producing a word 
result in AX (called 'byte-operation, word result' above). 

2. Multiply a word memory or register operand by a word in AX, producing a 
dword result in DX:AX (called 'word-operation, dword result' above). 

In both types of multiply the carry and overflow flags are used to signal whether the 
product has exceeded the precision of the operands which produced it. Thus, when 
multiplying two bytes, if the product is larger than can be expressed in a byte (i.e. 
prod > 256.) then the CY and OF flags will be set; otherwise, they will be cleared. 
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NEG 



Negate an Integer 

Format 

Memory/Reg 



Opcode 



ModRM* 



'—(Reg field = 011) 



Opcode 



Clocks 



Operation 



F6 




i 


Reg8- 


00H-Reg8 


F7 




i 


Reg16« 


-0000H-Reg16 


F6 


164 


EA 


Mem8*-00H-Mem8 


F7 


16h 


EA 


Mem16 


-0000H-Mem16 


Operation 











Coding Example 

NEG BL 

NEG BX 

NEG BYTESOMETHING 

NEG WORDSOMETHING 



Operand *- 2's complement of Operand 
Flags 

D I T S Z A P C 
X - - - X X X X 1 * 

*except when operand is zero, then CF-<- 



Description 

The two's complement of the register or memory operand replaces the old operand 
value. 
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NOP ASM86 

No Operation 



Format 



Opcode 



Opcode Clocks Operation Coding Example 

90 3 no operation NOP 

Operation 

Perform no operation. 

Flags 

ODITSZAPC 

Description 

NOP is a one-byte filler instruction which takes up space but affects none of the 
machine context except [P. 
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NOT 



Form One's Complement 



Format 










Memory/Reg 




Zl 




Opcode 


ModRM* | 








*— (Reg field = 010) 




Opcode 


Clocks Operation 




Coding Example 


F6 


3 Reg8-0FFH-Reg8 




NOT BL 


F6 


16 + EA Mem8*-0FFH-Mem8 




NOT BYTESOMETHING 


F7 


3 Reg16«-0FFFFH-Reg16 




NOT BX 


F7 


16 + EA Mem16-0FFFFH-Mem16 




NOT WORDSOMETHING 


Operation 











Operand — one's complement of Operand 



Flags 



ODITSZAPC 



Description 

The operand is inverted, that is, every 1 becomes a and vice versa. 
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Logical Inclusive OR 



Format 

Memory/Reg with Reg 



Opcode 



ModRM 



Z 



Opcode 



Clocks 



OA 


3 


OA 


9 + EA 


OB 


3 


OB 


9+EA 


08 


16+EA 


09 


16+EA 



Operation 

Reg8*-Reg8 0RReg8 
Reg8-Reg8 0RMem8 
Reg16 - Reg160R Reg 16 
Reg16 - Reg16 OR Mem16 
Mem8*-Mem8 0RReg8 
Mem16 «- Mem160R Reg16 



Coding Example 

OR BL.CL 

OR BL.BYTESOMETHING 

OR BX.CX 

OR BX.WORDSOMETHING 

OR BYTESOMETHING.BL 

OR WORDSOMETHING.BX 



Immed to AX/AL 



Opcode 



Data 



Zl 



Opcode 



Clocks 



Operation 



Coding Example 



oc 


4 


AL^ ALORImmed8 


OR AL,5 


0D 


4 


AX-AXORImmed16 


OR AX,400H 



Immed to Memory/Reg 



Opcode 


ModRM* 






Data 






*— (Reg field = 001) 




Opcode 


Clocks 


Operation 


Coding Example 


80 


4 


Reg8 - Reg8 OR Immed8 


OR BL.32 


80 


17+EA 


Mem8 *- Mem8 OR Immed8 


OR BYTESOMETHIh 


81 


4 


Reg16 - Reg16 OR Immed16 


OR BX.1234H 


81 


17+EA 


M 


em16 — Mem160F 


1 Immed16 


OR WORDSOMETHI 



z:z 



Operation 

LeftOpnd *- LeftOpnd or RightOpnd 
OF - CF - 



Flags 

DDITSZAPC 
- - - X X U X 



Description 

The inclusive OR of two operands replaces the left operand. The carry and overflow 
flags are cleared. 
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OUT 



Output Byte, Word 



Format 






Fixed port 






Opcode 


Port 


I 


Opcode 


Clocks 


Operation 


E6 


10 


Port8 - AL 


E7 


10 


Port8 - AX 


Variable port 






Opcode 





Coding Example 

OUT BYTEPORTNUMBER,AL 
OUT BYTEPORTNUMBER,AX 



Opcode 



Clocks 



Operation 



Coding Example 



EE 
EF 



Port16 (in DX)*- Al- 
ports (in DX)*- AX 



OUT DX,AL 
OUT DX.AX 



Operation 

if fixed-port then 

portnumber in instruction; 

< portnumber < OFFH; 
else 

portnumber in DX; 

< portnumber < OFFFFH; 
end if; 

if byte-output then ioportjportniumber] — AL; 
else ioport[portnumber] *- AX; 



Flags 

ODITSZAPC 



Description 

OUT transfers a byte from AL or a word from AX to the specified output port. Use 
of the fixed port format allows access to ports through FF, and encodes the port 
number in the instruction. To use the variable port format you load the DX register 
with a 16 bit port number and then code the mnemonic 'DX' in place of a constant 
port number. This format allows access to 64k ports. 
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POP 
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Pop a Word From the Stack 



Format 

Word Memory 



Opcode 



ModRM' 



*— (Reg field =000) 

Opcode Clocks Operation 

8F 17 + EA Mem16*-(SP)+ + 



3 



Coding Example 

POP WORDSOMETHING 



Word Register 



Opcode + reg 



Opcode Clocks Operation 

58 + reg 8 Reg16 - (SP)+ + 



Coding Example 

POP BX 



Segment Register 



Opcode + SReg 



Opcode Clocks Operation 

07+(SReg*8) 8 SReg - (SP)++ 



Coding Example 

POP DS 



Operation 

Operand ^TOS; 
SP-SP + 2; 



Flags 



ODITSZAPC 



Description 

The word on the top of the stack replaces the previous contents of the memory, 
register, or segment register operand. The stack pointer is incremented by 2 to point 
to the new top of stack. 

If the destination operand is a segment register, the value POPed will be a paragraph 
number. 

POP CS is NOT allowed. 
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POPA 



Pop All Registers [iAPX 186] 

For 186 clocks, see Appendix H. 



Format 



Opcode 



Opcode 



Operation 



61 restore registers from 

the stack 



Coding Example 

POPA 



Operation 

DI-(SP)++; 

SI«-(SP)++; 
BP-(SP)+ + ; 
SP-SP + 2; 
BX-(SP)++; 
DX-(SP)+ +; 
CX-(SP)+ + ; 
AX-(SP)++; 



/* POP AND IGNORE SP*/ 



Flags 



PLODITSZAPC 



Description 

POPA restores the registers pushed by PUSHA, except that the SP value is ignored. 
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POPF 
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Pop the TOS into the Flags 



Format 



Opcode 



Opcode Clocks 

9D 8 



Operation 

FLAGS *-(SP)+ + 



Coding Example 

POPF 



Operation 

Flags*- TOS; 
SP-SP + 2; 



Flags 

ODITSZAPC 
XXXXXXXXX 



Description 

The TOS is copied to the Flags and the stack pointer is incremented by 2 to point to 
the new top of stack. Bit position to flag assignments are: 



OF 


-bit11 


DF 


-bit 10 


IF 


- bit 9 


TF 


-bit 8 


SF 


-bit 7 


ZF 


-bit 6 


AF 


-bit 4 


PF 


-bit 2 


CF 


-bitO 
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PUSH 



Push a Word Onto the Stack 

For 186 clocks, see Appendix H. 

Format 

Memory/Reg 



Opcode 



ModRM' 



* — (Reg field=110) 



Z 



Opcode Clocks Operation 

FF 16+ EA — (SP)*-Mem16 



Coding Example 

PUSH WORDSOMETHING 



Word Register 



Opcode + reg 



Opcode Clocks Operation 

50 + reg 11 — (SP)-RegK 



Coding Example 

PUSH BX 



Word Immediate [iAPX 186] 



Opcode 



Data 



Z 



Opcode 



6A 



Operation 



— (SP) - ImmedS 
(sign extended) 
68 — (SP)-lmmed16 



Coding Example 

PUSH 5 
PUSH 400H 



Segment Register 



Opcode + SReg 



Opcode Clocks 

06+(SReg*8) 10 



Operation 

-(SP)-SReg 



Coding Example 

PUSH DS 



Operation 

SP-SP-2; 
TOS^- Operand; 



6-73 



PUSH 



ASM86 



Flags 

ODITSZAPC 

Description 

The stack pointer is decreased by 2 and the word operand is copied to the new top of 
stack. 
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PUSHA 



Push All Registers [iAPX 186] 

For 186 clocks, see Appendix H. 



Format 



Opcode 



Opcode Operation 

60 save registers on the stack 



Operation 

temp-SP; 
-(SP)-AX; 
-(SP)-CX; 
— (SP)-DX; 
— (SP)-BX; 
— (SP)*-temp; 
— (SP)-BP; 
-(SP)-SI; 
— (SP)«-DI; 



Coding Example 

PUSHA 



Flags 

NPLODITSZAPC 



Description 

PUSHA saves the registers noted above on the stack. 
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PUSHF 
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Push the Flags to the Stack 



Format 



Opcode 



Opcode Clocks Operation 

9C 10 — (SP)- FLAGS 



Coding Example 

PUSHF 



Operation 

SP-SP-2; 
TOS- Flags; 



Flags 



ODITSZAPC 



Description 

The stack pointer is decremented by 2 and the flags are copied to the new top of 
stack. Flag to bit position assignments are: 



bit 11 


-OF 


bit 10 


-DF 


bit 9 


-IF 


bit 8 


-TF 


bit 7 


-SF 


bit 6 


-ZF 


bit 4 


-AF 


bit 2 


-PF 


bitO 


-CF 
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RCL 



Rotate Left Through Carry 

For 186 clocks, see Appendix H. 

Format 

Memory or Reg by 1 



Opcode 



ModRIW 



*— (Reg field = 010) 



n 



Opcode 



Clocks 



Operation 



DO 


2 


rotate Reg 8 by 1 


DO 


15 + EA 


rotate Mem8by 1 


D1 


2 


rotate Reg 16 by 1 


D1 


15 + EA 


rotate Mem16 by 1 



Coding Example 

RCL BL,1 

RCL BYTESOMETHING.1 

RCL BX.1 

RCL WORDSOMETHING,1 



Memory or Reg by count in CL 



Opcode 



ModRM* 



*— (Reg field = 010) 



~U 



icode 


Clocks 


Operation 


D2 


8 + 4/bit 


rotate Reg8 by CL 


D2 


20 + EA + 4/bit 


rotate Mem8 by CL 


D3 


8 + 4/bit 


rotateReg16byCL 


D3 


20 + EA + 4/bit 


rotate Mem16byCL 



Coding Example 

RCL BL,CL 

RCL BYTESOMETHING,CL 

RCL BX,CL 

RCL WORDSOMETHING.CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 



ModRM* 



*— (Reg field = 011) 

Opcode Operation 

CO rotate Reg8 by Immed8 

CO rotate Mem8 by Immed8 

C1 rotate Reg16 by Immed8 

C1 rotate Mem16 by Immed8 



count 



Coding Example 

RCL BL,5 

RCL BYTESOMETHING,5 

RCL BX,5 

RCL WORDSOMETHING,5 



Operation 

if variable-bit-rotate then count=CL or count=lmmed8; 

elsecount=1; 
do until count=0 

tempcf «-CF; 

CF — high-order-bit of operand; 

operand *- operand * 2 + tempcf; 

count*- count-1; 
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end do; 

if not variable-bit-rotate then do; 

if high-order-bit of operand <> CF then OF — 1 ; 

else OF-U; 
end if; 

Flags 

ODITSZAPC 

x-------x 

Description 

The register or memory operand is rotated left through the CF according to the shift 
count, which may be either a fixed count of 1 or a variable count that has been 
loaded into the CL register. If the shift count is 1, the overflow flag is set if the high 
bit of the rotated operand differs from the resulting carry flag. Only CF and OF are 
affected. 



6-78 



ASM86 



RCR 



Rotate Right Through Carry 

For 186 clocks, see Appendix H. 

Format 

Memory or Reg by 1 



Opcode 



ModRM' 



-(Reg field = 011) 



3 



Opcode 



Clocks 



Operation 



DO 


2 


rotate Reg8 by 1 


DO 


15+EA 


rotate Mem8 by 1 


D1 


2 


rotate Reg16by 1 


D1 


15+EA 


rotate Mem16 by 1 



Coding Example 

RCR BL,1 

RCR BYTESOMETHING,1 

RCR BX,1 

RCR WORDSOMETHING.1 



Memory or Reg by count in CL 



Opcode 



ModRM* 



*— (Reg field = 011) 



~Z2 



Opcode 

D2 
D2 
D3 
D3 



Clocks 



Operation 



8 + 4/bit rotate Reg8 by CL 

20 + EA + 4/bit rotate Mem8 by CL 

8 + 4/bit rotate Reg16 by CL 

20 + EA + 4/bit rotate Mem16 by CL 



Coding Example 

RCR BL.CL 

RCR BYTESOMETHING,CL 

RCR BX.CL 

RCR WORDSOMETHING.CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 


ModRM* 


| 


count 




*— (Reg field = 011) 




Opcode 


Operation 


Coding Example 


CO 


rotate Reg8 by Immed8 


RCR BL,5 


CO 


rotate Mem8 by Immed8 


RCR BYTESOMETHING,5 


C1 


rotate Reg16 by Immed8 


RCR BX,5 


C1 


rotate Mem16 by Immed8 


RCR WORDSOMETHING.5 


Operation 











if variable-bit-rotate then count=CL or count=lmmed8; 
else do; 

count=1; 

if high-order-bit of operand <> CF then OF — 1 ; 

else OF-0; 
end if; 
do until count=0 

tempcf •<- CF; 

CF «- low-order-bit of operand; 
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operand *- operand / 2; 
high-order-bit of operand *- tempcf; 
count «-count-1; 
end do; 

Flags 

ODITSZAPC 

x-------x 

Description 

The register or memory operand is rotated right through the CF according to the 
shift count, which may be either a fixed count of 1 or a variable count that has been 
loaded into the CL. register. If the shift count is 1, the overflow flag is set if the high 
bit of the un-rotated operand differs from the original carry flag. Only CF and OF 
are affected. 
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REP 
REP/REPZ/REPE/REPNE/REPNZ 



Repeat Prefix 






Format 








Opcode 




Opcode 


Clocks 


Operation 


Coding Example 


F3 


2 


repeat next instruction until 

cx=o 


REP MOVSB 


F3 


2 


repeat next instruction until 


REPE SCASB 






CX=0orZF=1 


REPZ SCASB 


F2 


2 


repeat next instruction until 


REPNE SCASB 






CX=0orZF=0 


REPNZ SCASB 



Operation 

do while CX <>0; 
/* acknowledge pending interrupts */ 
/* perform string operation in subsequent byte * / 
CX «- CX - 1 ; / * does not affect flags * / 
if string operation = SCAS or CMPS and 
ZF <> repeat condition then undo; 

end do; 



Flags 



ODITSZAPC 



Description 

The REP prefix causes a succeeding string operation to be repeated until the count in 
CX goes to zero (REP causes CX to be decremented after each repetition of the 
string op). If the string operation is either SCAS or CMPS (or a variant of those 
such as SCASB...) then the ZF is compared to the repeat condition after the string 
op is performed, and the repeat is terminated if the ZF does not match the condi- 
tion. For example, REPE SCASB will scan a string, comparing each byte to the AL 
register, as long as the ZF is 1, indicating 'EQUAL'. 

REP, REPE, and REPZ are synonymous, as are REPNZ and REPNE. 

Execution of the repeated string operation will not resume properly following an 
interrupt if more than one prefix is present preceding the string primitive. Execution 
will resume one byte before the primitive (presumably where the repeat resides), thus 
ignoring the additional prefixes. 
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Return From Subroutine 



Format 



Opcode 



Opcode Clocks Operation 

C3 8 intra-segment return 

CB 18 inter-segment return 



Coding Example 

RET 
RET 



Return and add constant to SP 



Opcode 


DataL 


DataH 






Opcode 


Clocks 


Operation 


Coding Example 


C2 


12 


intra-segment ret and add 


RET 8 


CA 


17 


inter-segment ret and add 


RET 8 


Operation 













IP-(SP) + +; 

SP-SP + 2; 

if intersegment then 

CS - (SP) + + ; 

SP-SP + 2; 
if add immediate to SP then 

SP*-SP + immediate constant; 



Flags 

ODITSZAPC 



Description 

RET transfers control through a back-link on the stack, reversing the effects of a 
CALL instruction. If the intra-segment RET is used, the back-link is assumed to be 
just the return-IP, while inter-segment RETs assume both IP and CS are on the 
stack. RETs may optionally add a constant to the stack pointer, effectively remov- 
ing any arguments to the called routine which were pushed prior to the CALL. 
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Rotate Left 

For 186 clocks, see Appendix H. 

Format 

Memory or Reg by 1 



Opcode ModRM 



*— (Reg field = 000) 



ZD 



Opcode 



Clocks 



Operation 



DO 


2 


rotate Reg8 by 1 


DO 


15 + EA 


rotate Mem8by 1 


D1 


2 


rotate Reg16 by 1 


D1 


15 + EA 


rotate Mem16 by 1 



Coding Example 

ROL BL,1 

ROL BYTESOMETHING.1 

ROL BX,1 

ROL WORDSOMETHING.1 



Memory or Reg by count in CL 



Opcode 



ModRM' 



*— (Reg field = 000) 



ID 



Opcode 



Clocks 



Operation 



D2 


8 + 4/bit 


rotate Reg8 by CL 


D2 


20 + Ea + 4/bit 


rotate Mem8 by CL 


D3 


8 + 4/bit 


rotate Reg16 by CL 


D3 


20 + EA + 4/bit 


rotate Mem16 by CL 



Coding Example 

ROL BL,CL 

ROL BYTESOMETHING.CL 

ROL BX.CL 

ROL WORDSOMETHING,CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 



ModRM* 



count 





*— (Reg field = 000) 




Opcode 


Operation 


Coding Example 


CO 


rotate Reg8 by Immed8 


ROL BL,5 


CO 


rotate Mem8 by Immed8 


ROL BYTESOMETHING,5 


C1 


rotate Reg16 by Immed8 


ROL ,BX,5 


C1 


rotate Mem16 by Immed8 


ROL WORDSOMETHING,5 


Operation 







if variable-bit-rotate then count=CL or count=lmmed8; 

elsecount=1; 

do until count=0 

CF *- high-order-bit of operand; 

operand *- operand * 2 + CF; 

count "-count- 1; 
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end do; 

if not variable-bit-rotate then do; 

if high-order-bit of operand <> CF then OF — 1 ; 

else OF«-0; 
end if; 

Flags 

ODITSZAPC 
X-------X 

Description 

The register or memory operand is rotated left according to the shift count, which 
may be either a fixed count of 1 or a variable count that has been loaded into the CL 
register. The high order bit of the operand is copied directly to the low order bit dur- 
ing the rotate, as well as to CF. If the shift count is 1, the overflow flag is set if the 
high bit of the rotated operand differs from the resulting carry flag. (That is, if the 
high and low order bits of the result are not the same.) Only CF and OF are affected. 
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ROR 



Rotate Right 

For 186 clocks, see Appendix H. 

Format 

Memory or Reg by 1 



Opcode 



ModRM* 



*— (Reg field = 001! 



>code 


Clocks 


Operation 


DO 


2 


rotate Reg8 by 1 


DO 


15+EA 


rotate Mem8 by 1 


D1 


2 


rotate Reg16 by 1 


D1 


15 + EA 


rotate Mem16 by 1 



Coding Example 

ROR BL,1 

ROR BYTESOMETHING,1 

ROR BX,1 

ROR WORDSOMETHING.1 



Memory or Reg by count in CL 



Opcode 



ModRM' 



"— (Reg field = 001) 



Zl 



icode 

D2 


Clocks 

8 + 4/bit 


Operation 

rotate Reg8 by CL 


D2 


20 + EA + 4/bit 


rotate Mem8 by CL 


D3 


8 + 4/bit 


rotateReg16byCL 


D3 


20 + EA + 4/bit 


rotateMem16byCL 



Coding Example 

ROR BL.CL 

ROR BYTESOMETHING.CL 

ROR BX,CL 

ROR WORDSOMETHING.CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 


ModRM* | 




*— (Reg field = 001) 


Opcode 


Operation 


CO 


rotate Reg8 by Immed8 


CO 


rotate Mem8 by Immed8 


C1 


rotate Reg16 by !mmed8 


C1 


rotate Mem16 by Immed8 


Operation 







count 



Coding Example 

ROR BL,5 

ROR BYTESOMETHING,5 

ROR BX,5 

ROR WORDSOMETHING,5 



if variable-bit-rotate then count==CL or count=lmmed8; 

elsecount = 1; 
do until count = 

tempcf *- CF; 

CF «- low-order-bit of operand; 

operand *- operand / 2; 

high-order-bit of operand «- CF; 
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count — count-1; 
end do; 
if not variable-bit-rotate then do; 

if high-order-bit of operand <> CF then OF«-1; 

elseOF*-0; 
end if; 



Flags 



D I T S Z A P C 

x-------x 

Description 

The register or memory operand is rotated right according to the shift count, which 
may be either a fixed count of 1 or a variable count that has been loaded into the CL 
register. The low bit of the operand is copied directly to the high bit during the 
rotate, as well as to the CF. If the shift count is 1, the overflow flag is set if the high 
bit of the rotated operand differs from the un-rotated high bit. Only CF and OF are 
affected. 
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SAHF 



Store AH in Flags 



Format 



Opcode 



Opcode 


Clocks 


Operation 


Coding Example 


9E 


4 


copy AH to low byte of flags 
word 


SAHF 



Operation 

AH - SF:ZF:X:AF:X:PF:X:CF 
/* 'X' indicates non-specified bit value */ 

Flags 

ODITSZAPC 

----xxxxx 

Description 

The Sign, Zero, Auxiliary carry, Parity, and Carry Flags are loaded from AH in the 
following format: 

AHbit7 goes to SF 
AH bit6 goes to ZF 
AH bit4 goes to AF 
AH bit2 goes to PF 
AH bitO goes to CF 

No other flags are altered. 
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Arithmetic /Logical Left Shift 

For 186 clocks, see Appendix H. 



Format 

Memory or Reg by 1 



Opcode 



ModRM' 





*-(Regf 


ield = 100) 


>code 


Clocks 


Operation 


DO 


2 


shift Reg8 by 1 


DO 


15+EA 


shift Mem8 by 1 


D1 


2 


shift Reg16 by 1 


D1 


15+EA 


shiftMem16by 1 



Z 



Coding Example 

SAL BL,1 

SHL BYTESOMETHING.1 

SHL BX,1 

SAL WORDSOMETHING.1 



Memory or Reg by count in CL 



Opcode 



ModRM* 



*— (Reg field = 100) 



Zl 



>code 


Clocks 


Operation 


D2 


8 + 4/bit 


shift Reg8 by CL 


D2 


20 + EA + 4/bit 


shift Mem8 by CL 


D3 


8 + 4/bit 


shiftReg16byCL 


D3 


20 + EA + 4/bit 


shiftMem16by CL 



Coding Example 

SHL BL,CL 

SAL BYTESOMETHING.CL 

SAL BX.CL 

SHL WORDSOMETHING,CL 



Mem or Reg by immediate count [iAPX 186] 



Opcode 


ModRM* 






count 




*— (Reg field = 100) 




Opcode 


Operation 


Coding Example 


CO 


rotate Reg8 by Immed8 


SHL BL,5 


CO 


rotate Mem8 by Immed8 


SAL BYTESOMETHING,5 


C1 


rotate Reg16 by Immed8 


SAL BX,5 


C1 


rotate Mem16 by Immed8 


SHL WORDSOMETHING,5 


Operation 













if variable-bit-shift then count=CL or count=lmmed8; 

elsecount=1; 
do until count=0 

CF «- high-order-bit of operand; 

operand *- operand * 2; 

count*- count-1; 
end do; 
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if not variable-bit-shift then do; 

if high-order-bit of operand <> CF then OF 

else OF-0; 
end if; 



Flags 



QDITSZAPC 
X - - - X X U X X 



Description 

SHL (shift logical left) and SAL (shift arithmetic left) shift the operand left by 
COUNT bits, shifting in low-order zero bits. 
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Arithmetic Right Shift 

For 186 clocks, see Appendix H. 

Format 

Memory or Reg by 1 



Opcode 



ModRM* 



*— (Reg field = 111) 



n 



icode 


Clocks 


Operation 


DO 


2 


shift Reg8 by 1 


DO 


15+EA 


shift Mem8 by 1 


D1 


2 


shift Reg16by 1 


D1 


15+EA 


shift Mem 16 by 1 



Coding Example 

SAR BL,1 

SAR BYTESOMETHING.1 

SAR BX,1 

SAR WORDSOMETHING.1 



Memory or Reg by count in CL 



Opcode 



ModRM* 



*— (Reg field = 111) 



3 



>code 


Clocks 


Operation 


D2 


8 + 4/bit 


shift Reg8 by CL 


D2 


20 + EA + 4/bit 


shift Mem8 by CL 


D3 


8 + 4/bit 


shiftReg16by CL 


D3 


20 + EA + 4/bit 


shift Mem16by CL 



Coding Example 

SAR BL.CL 

SAR BYTESOMETHING.CL 

SAR BX.CL 

SAR WORDSOMETHING.CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 


ModRM* 






count 




*— (Reg field = 111) 




Opcode 


Operation 


Coding Example 


CO 


rotate Reg8 by Immed8 


SAR BL,5 


CO 


rotate Mem8 by Immed8 


SAR BYTESOMETHING,5 


C1 


rotate Reg16 by Immed8 


SAR BX,5 


C1 


rotate Mem16 by Immed8 


SAR WORDSOMETHING.5 


Operation 













if variable-bit-shift then count=CL or count=lmmed8; 

else count=1; 
do until count=0 

CF "- low-order-bit of operand; 

operand - operand / 2; /* SIGNED DIVIDE */ 

count «- count- 1; 
end do; 
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if not variable-bit-shift then do; 

OF-0; 
end if; 



Flags 

ODITSZAPC 
X---XXUXX 



Description 

SAR (shift arithmetic right) shifts the operand right by COUNT bits, shifting in 
high-order bits equal to the original high-order bit of the operand (sign extension). 
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Integer Subtraction With Borrow 



Format 

Memory/Reg with Reg 



Opcode 



ModRM 



3 



Opcode 



Clocks 



1A 


3 


1A 


9+EA 


1B 


3 


1B 


9 + EA 


18 


16+EA 


19 


16+EA 



Operation 

Reg8*-Reg8-Reg8-CF 
Reg8«-Reg8-Mem8-CF 
Reg16-Reg16-Reg16-CF 
Reg16 - Regl6- Mem16 - CF 
Mem8 «- Mem8 - Reg8 - CF 
Mem16*-Mem16-Reg16-CF 



Coding Example 

SBB BL.CL 

SBB BL,BYTESOMETHING 

SBB BX,CX 

SBB BX,WORDSOMETHING 

SBB BYTESOMETHING.BL 

SBB WORDSOMETHING,BX 



Immed from AX/AL 



Opcode 



Data 



3 



Opcode 



Clocks 



Operation 



Coding Example 



1C 


4 


AL*-AL-lmmed8-CF 


SBB AL,5 


1D 


4 


AX-AX-lmmed16-CF 


SBB AX.400H 



Immed from Memory/Reg 



Opcode 



ModRM' 



l — (Reg field = 011) 



Data 



Z] 



Opcode 



Clocks 



Operation 



80 


4 


80 


17+EA 


81 


4 


81 


17+EA 


83 


4 


83 


17+EA 



Reg8 «- Reg8 - Immed8 - CF 
Mem8 - Mem8 - Immed8 - CF 
Reg16 - Reg1 6 - Immed16 - CF 
Mem16 — Mem16 - Immed16 - CF 
Reg16 - Reg16 - Immed8 - CF 
Mem16 «- Mem16 - Immed8 - CF 
(Immed8 is sign-extended 
before subtract) 



Coding Example 

SBB BL.32 

SBB BYTESOMETHING,32 

SBB BX.1234H 

SBB WORDSOMETHING,1234H 

SBB BX,32 

SBB WORDSOMETHING,32 



Operation 

LeftOpnd — LeftOpnd - RightOpnd - CF 

Flags 

ODITSZAPC 
X---XXXXX 
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Description 

The result of subtracting the right operand, then the original value of the carry flag, 
from the left operand replaces the left operand. 



6-93 



SHR 



ASM86 



Logical Right Shift 

Format 

Memory or Reg by 1 



3 



Opcode 



ModRM' 



*— (Reg field = 101) 



>code 


Clocks 


Operation 


DO 


2 


shift Reg8 by 1 


DO 


15+EA 


shift Mem8 by 1 


D1 


2 


shift Reg 16 by 1 


D1 


15+EA 


shiftMem16by 1 



Coding Example 

SHR BL,1 

SHR BYTESOMETHING.1 

SHR BX,1 

SHR WORDSOMETHING,1 



Memory or Reg by count in CL 



Opcode 



ModRM* 



*— (Reg field = 101) 



Zl 



>code 


Clocks 


Operation 


D2 


8 + 4/bit 


shift Reg8 by CL 


D2 


20+Ea + 4/bit 


shift Mem8 by CL 


D3 


8 + 4/bit 


shiftReg16byCL 


D3 


20 + EA + 4/bit 


shiftMem16byCL 



Coding Example 

SHR BL.CL 

SHR BYTESOMETHING,CL 

SHR BX.CL 

SHR WORDSOMETHING.CL 



Mem or Reg by Immed8 [iAPX 186] 



Opcode 



ModRM* 



*— (Reg field = 101! 



count 



Opcode 



Operation 



CO 


rotate Reg8 by Immed8 


CO 


rotate Mem8 by Immed8 


C1 


rotate Reg16 by Immed8 


C1 


rotate Mem16 by Immed8 


Operation 





Coding Example 

SHR BL,5 

SHR BYTESOMETHING,5 

SHR BX,5 

SHR WORDSOMETHING,5 



if variable-bit-shift then count=CL or count=lmmed8; 

else do; 

count=1; 

OF «~ high-order-bit of operand; 
end if; 
do until count=0 

CF «- low-order-bit of operand; 

operand *- operand / 2; 

count *- count- 1; 
end do; 



/* UNSIGNED DIVIDE*/ 
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Flags 



D I T S Z A P C 
X - - - X X U X X 



Description 

SHR shifts the operand right by COUNT bits, shifting in high-order zero bits. 
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Set Carry Flag 

Format 



Opcode 



Opcode Clocks Operation 

F9 2 set the carry flag 

Operation 

CF-1 



Flags 



D I T S Z A P C 



Coding Example 

STC 



Description 

STC sets the carry flag, CF. No other flags are affected. 
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STD 



Set Direction Flags 

Format 



Opcode 



Opcode Clocks Operation Coding Example 

FD 2 set direction flag STD 

Operation 

DF-1 

Flags 

ODITSZAPC 
-1------- 

Description 

STD sets the direction flag, DF. No other flags are affected. 
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Set Interrupt Enable Flag 



Format 



Opcode 



Opcode 


Clocks 


Operation 


FB 


2 


set interrupt flag 


Operation 






IF*-1 







Coding Example 

STI 



Flags 



ODITSZAPC 



Description 

STI sets the interrupt enable flag, IF. No other flags are affected. 
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String Operations 

For 186 clocks, see Appendix H. 
Format 



Opcode 










Opcode 


Clocks 


Operation 


Coding 


Example 


A6 


22 


flags- (SI) -(Dl) 


CMPS 


BSTRING 


A7 


22 


flags- (SI) -(Dl) 


CMPS 


WSTRING 


A4 


18 


(DI)-(SI) 


MOVS 


BSTRING1,BSTRING2 


A5 


18 


(DI)-(SI) 


MOVS 


WSTRING1.WSTRING2 


AE 


15 


flags -(DI)-AX 


SCAS 


BSTRING 


AF 


15 


flags -(DI)-AL 


SCAS 


WSTRING 


AC 


12 


AL-(SI) 


LODS 


BSTRING 


AD 


12 


AX - (SI) 


LODS 


WSTRING 


AA 


11 


(Dl)- AL 


STOS 


BSTRING 


AB 


11 


(Dl) -AX 


STOS 


WSTRING 


6E 




(DI)-port(DX) 


INS 


BSTRING, DX 


6F 




(DI)«-port(DX:DX + 1) 


INS 


WSTRING, DX 


6C 




port(DX)-(SI) 


OUTS DX, BSTRING 


6D 




port(DX:DX+1)*-(SI) 


OUTS DX, WSTRING 



Operation 

do until CX = 0; 

/* acknowledge any pending interrupts */ 

perform string primitve once; 

CX-CX-1; /* does not affect flags*/ 

if DF = then add pointer adjustment to DS and/or ES 

else subtract pointer adjustment from DS and/or ES; 

if SCAS or CMPS, and repeat condition does not match ZF 

then undo; 
end do; 



Description 

The string primitive operations are intended to be used primarily with the REP 
prefix. There are 7 primitives which, when so prefixed, perform the following 
operations: 



Flags 



D D I T S Z A P C 
X - ■ - - X X X X X 



CMPS 

CMPSB 

CMPSW 



Compare the elements of two strings, one pointed to by ES:DI and the 
other by DS:SI. 
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Flags 

D I T S Z A P C 



MOVS 

MOVSB 

MOVSW 



Move the string pointed to by DS:SI into memory pointed to by ES:DI. 



Flags 

D I T S Z A P C 
X - - - X X X X X 

SCAS Scan a string pointed to by ES:DI, comparing each element to AX or 

SCASB AL according to the type of string, and setting the flags to the result 

SCASW of such a comparison. Used with the conditional repeat-prefix 

(REPE,...), this primitive can locate the next element matching 

AX/AL or next not-matching elemert. 



Flags 



D I T S Z A P C 



LODS Load each string element into AX/AL. This primitive would be used 

LODSB with the LOOP construct rather than the REP prefix, since some further 

LODSW processing on the data moved to AX/AL is almost surely necessary. 



Flags 

Q D I T S Z A P C 



STOS 

STOSB 

STOSW 



Store the AX or AL contents into the entire string. 



The following operations are for iAPX 1 86 

INS 



OUTS 



Store in memory pointed to by ES:DI the block of bytes or words read 
from the 10 address in DX. 

Output to the IO address in DX the block of bytes/words in memory 
pointed to by DS:SI. 



Each repetition of the string operation acknowledges pending interrupts, checks CX 
for zero (and stops repeating if 0), performs the string primitive operation once, adjusts 
any memory pointers used by the string operation by 1 for bytes and 2 for words (the 
adjustment is added if the FLAGS. DF is 0, otherwise subtracted), decrements CX 
(which does not affect the flags), and, in the case of SCAS and CMPS or their 
variants, checks the ZF for a match with the REP condition. As long as the REP 
condition matches, another repetition will be performed. For example, REPNE SCAS 
FOO will stop with ES:DI pointing to the next element of FOO which has not yet 
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String 



been scanned, and the last element scanned did not match the repeat condition 'Not 
Equal'-that is, the last element scanned matched the value in AX or AL, depending 
on whether FOO was a word or byte string. Repeat conditions 'NE' and 'NZ' match 
ZF = 0, while 'E' and 'Z' match ZF= 1. 

Every string primitive has three variants. The mnemonics above, CMPS, MOVS, 
SCAS, LODS, INS, and OUTS, are generic and require one or more operands to be 
coded with them-e.g. REP SCAS FOO or REP MOVS FEE,FIE. These operands 
are used only to determine the size of a string element-byte or word-and do not 
determine the addresses of the strings used. The addresses used are determined solely 
by the contents of the register pairs ES:DI and DS:SI, as appropriate. Rather than 
coding operands for size specification, you may use the generic mnemonic with a 'W 
or 'B' suffix-e.g. STOSB or CMPSW-and omit the operands entirely. 

For Repeat String Operations, Clocks are: 

Clocks Coding Example 

9 + 17/rep REP MOVSB 

9+22/rep REPE CMPSW 

9 + 15/rep REPNE SCASB 

9 + 13/rep REP LODSB 

9+10/rep REP STOSW 
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Integer Subtraction 



Format 

Memory/Reg with Reg 



Opcode 



ModRM 



Opcode 



Clocks 



Operation 



2A 


3 


Reg8*-Reg8-Reg8 


2A 


9 + EA 


Reg8*-Reg8-Mem8 


2B 


3 


Reg16*-Reg16-Reg16 


2B 


9 + EA 


Reg16«- Reg16-Meml6 


28 


16+EA 


Mem8*-Mem8-Reg8 


29 


16 + EA 


Mem16 < -Mem16-Reg16 



Coding Example 

SUB BL.CL 

SUB BL.BYTESOMETHING 

SUB BX.CX 

SUB BX.WORDSOMETHING 

SUB BYTESOMETHING.BL 

SUB WORDSOMETHING.BX 



Immed to AX/AL 



Opcode 



Data 



>code 


Clocks 


Operation 


2C 


4 


AL *- AL-lmmed8 


2D 


4 


AX*-AX-lmmed1 



Coding Example 

SUB AL,5 
SUB AX.400H 



Immed to Memory/Reg 



Opcode 



ModRM* 



'— (Reg field = 101) 



Data 



Opcode 



81 
81 
83 
83 



Clocks Operation 

4 Reg8^-Reg8-lmmed8 

17+EA MemS-"- Mem8-lmmed8 

4 Reg16 — Reg16- Immed16 

17 + EA Mem16*-Mem16-lmmed16 

4 Reg16*-Reg16-lmmed8 

17 + EA Mem16 — Mem16-lmmed8 

(Immed8 is sign-extended 
before subtract) 



Coding Example 


SUB 


BL,32 


SUB 


BYTESOMETHING.32 


SUB 


BX.1234H 


SUB 


WORDSOMETHING.1234H 


SUB 


BX,32 


SUB 


WORDSOMETHING.32 



Operation 

LeftOpnd <- LeftOpnd - RightOpnd 

Flags 

ODITSZAPC 
X---XXXXX 



Description 

The result of subtracting the right operand from the left operand replaces the left 
operand. 
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TEST 



Logical Compare 



Format 

Memory/Reg with Reg 



Opcode 



ModRM 



zz 



Opcode 



Clocks 



Operation 



84 


3 


flags -Reg8 AND Reg8 


84 


9+EA 


flags <- Reg8 AND Mem8 


85 


3 


flags *-Reg16 AND Reg16 


85 


9 + EA 


flags «- Reg16 AND Mem16 



Coding Example 

TEST BL,CL 

TEST BL.BYTESOMETHING 

TEST BX,CX 

TEST BX,WORDSOMETHING 



Immed to AX/AL 



Opcode 



Data 



Z 



Opcode 



Clocks 



Operation 



Coding Example 



A8 


4 


flags*- ALAND Immed8 


TEST AL,4 


A9 


4 


flags *- AX AND Immed16 


TEST AX.400H 



Immed to Memory/Reg 



Opcode 



ModRM' 



A — (Reg field = 000) 



Opcode 



Clocks 



Operation 



F6 


5 


flags - Reg8 AND Immed8 


F6 


11+EA 


flags — Mem8 AND Immed8 


F7 


5 


flags - Reg16 AND Imrned16 


F7 


11 + EA 


flags - Mem16 AND ImmedK 


Operation 







flags *- LeftOpnd and RightOpnd 
OF - CF - 



Flags 

D I T S Z A P C 
0---XXUX0 



Data 



Z 



Coding Example 

TEST BL.3FH 

TEST BYTESOMETHING.3FH 

TEST BX,3FFH 

TEST WORDSOMETHING,3FFH 



Description 

The result of a bitwise logical AND of the two operands modifies the flags. Neither 
operand is modified. 
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Wait While TEST pin not Asserted 



Format 



Opcode 



Opcode Clocks Operation Coding Example 

9B 3 + 5n* none WAIT 

*3 + 5n clocks where n is the number of times the TEST line is polled and found to be inactive. 

Operation 

None. 



Flags 



ODITSZAPC 



Description 

The WAIT instruction causes the processor to enter a wait state if the signal on a 
TEST pin is not asserted. The wait state may be interrupted by an enabled external 
interrupt. When this occurs the saved code location is that of the WAIT instruction, 
so that upon return from the interrupting task the wait state is re-entered. The wait 
state is cleared and execution resumed when the TEST signal is asserted. Execution 
resumes without allowing external interrupts until after the execution of the next 
instruction. The instruction allows the processor to synchronize itself with external 
hardware. 
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XCHG 



Exchange Memory/Register With Register 



Format 










Memory/Reg 


with Reg 








Opcode 


ModRM | 


_ n 




Opcode 


Clocks 


Operation 




Coding Example 


86 


4 


Reg8 — Reg8 




XCHG BL.CL 


86 


17+EA 


Mem8-< — - Mem8 




XCHG BYTESOMETHING.CL 


87 


4 


Reg16*— -Reg16 




XCHG BX.CX 


87 


17+EA 


Mem16<— Mem16 




XCHG CX.WORDSOMETHING 



Word Register with AX 



Opcode + Reg 



Opcode 

90 + Reg 



Clocks 

3 



Operation 

AX --RegK 



Coding Example 

XCHG AX.BX 



Operation 

temp *- left operand; 

left operand *- right operand; 

right operand *- temp; 



Flags 



ODITSZAPC 



Description 

The two operands are exchanged. Segment registers are not legal operands. The 
order of the operands is immaterial. No flags are affected. 
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Table Look-up Translation 



Format 



Opcode 



Opcode Clocks Operation 



D7 
D7 



Coding Example 



1 1 replace AL with table entry XLAT ASCILTABLE 

1 1 XLATB 



Operation 

AL — table entry with effective address equal to BX + AL; 

Flags 

ODITSZAPC 



Description 

XLAT is intended for use as a table look-up instruction. You put the base address of 
the table in BX and a byte to be translated in AL. XLAT adds AL to the contents of 
BX and uses the result as an effective address. The byte at that EA is loaded into 
AL. BX is unchanged, and no flags are modified. 
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XOR 



Logical Exclusive OR 



Format 

Memory/Reg with Reg 



Opcode 



ModRM 



H 



Opcode 



Clocks 



Operation 



Coding Example 



32 


3 


Reg8*-Reg8XORReg8 


32 


9 + EA 


Reg8 *- Reg8 XOR Mem8 


33 


3 


Reg16 - Reg16 XOR Regie 


33 


9 + EA 


Reg16 - Reg16 XOR Mem16 


30 


16 + EA 


Mem8 «- Mem8 XOR Reg8 


31 


16+EA 


Mem16 - Mem16 XOR Reg16 


Immed to AX/AL 




Opcode 


Data 


n n 



XOR BL.CL 

XOR BL.BYTESOMETHING 

XOR BX.CX 

XOR BX.WORDSOMETHING 

XOR BYTESOMETHING.BL 

XOR WORDSOMETHING.BX 



Opcode 



Clocks 



Operation 



Coding Example 



AL- 
AX 



ALXORImmed8 
•AXXORImmedie 



XOR AL,5 
XOR AX.400H 



Immed to Memory/Reg 



Opcode 



ModRM* 



-(Reg field = 110) 



Data 



3 



Opcode 



Clocks 



Operation 



Coding Example 



80 


4 


80 


17+EA 


81 


4 


81 


17+EA 


Operation 





Reg8 «- Reg8 XOR Immed8 
Mem8 - Mem8 XOR Immed8 
Reg16 *- Reg16 XOR Immed16 



XOR BL,32 

XOR BYTESOMETHING,32 

XOR BX,1234H 



Mem16«-Mem16XORImmed16 XOR WORDSOMETHING,1234H 



LeftOpnd *- LeftOpnd XOR RightOpnd 
OF-CF -0 



Flags 



D I T S Z A P C 
0---XXUX0 



Description 

The exclusive OR of two operands replaces the left operand. The carry and overflow 
flags are cleared. 
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The 8087 Instruction Set 

This section provides a summary discussion of those elements of the 8087 Numeric 
Processor that are of specific interest to the 8087 programmer. The following pro- 
grammer accessible features of the architecture are included: floating-point stack; 
status, control and tag words; exception pointers; and data types. An elementary 
description of 8087 operation is provided to give a working understanding of 
8086/8087/8088 coprocessing, 8087 numeric processing, exception handlers, and 
8087 emulators. 

Those users who wish detailed information on the 8087 architecture, operation, 
and/or those who wish to write their own exception handlers are referred to The 
8086 Family User's Manual, Numerics Supplement, Order No. 121586. 



8087 Architectural Summary 

The programmer accessible features of the 8087 Numeric Processor architecture 
consist of the eight floating-point stack elements; the seven words which constitute 
the 8087 environment (status word, control word, tag word, 2-word instruction 
address, and 2-word data address); and the seven data types accessible by the 8087. 



Floating-Point Stack 

The 8087 stack consists of eight elements divided into the fields shown in figure 6-1 . 
The format of the fields corresponds with the temporary real data format used in all 
stack calculations and described under Data Types. 

At a given point in time, the ST field in the status word identifies the current stack 
top element. This floating point stack element (rather than the status word field) is 
referred to in the rest of this chapter as ST. A load (push) operation, as in FLDLN2, 
decrements the stack pointer by 1 and loads a value (in this case log e 2) into the new 
stack top. An operation which pops the floating point stack increments the stack 
pointer by 1 (FADDP ST(i),ST adds the contents of the stack top to the stack ele- 
ment designated by (i), stores the result in ST(i) and increments the stack pointer by 
1 , making ST(1) the new stack top, ST(0). 



64 63 



s 


EXPONENT 


SIGNIFICAND 













































ST3 

ST2 

ST1 

ST(0) 

ST(7) 

ST(6) 

ST(5) 

ST(4) 



STACK POINTER 



TOP 



Figure 6-1 . The 8087 Stack Fields 
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Elements of the floating point stack can be addressed either implicitly or explicitly: 

FST ST(3) Stores the contents of the stack top into element 3 . 

FADD Adds the contents of the stack top to the contents of ST(1), 

stores the result in ST(1) and pops the stack. The result is now 
in the new stack top. 

Note that floating-point stack indices outside of the range 0-7 are flagged as "out of 
range." 

Environment 

The 8087 environment consists of the seven words shown in figure 6-2. 
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B 


C3 




ST 




C2 


C1 


CO 


IR 


* 


PE 


UE 


OE 


ZE 


DE 


IE 


1 




IC 


RC 
1 


PC 

I 


IEM 


* 


PM 


UM 


* 


ZM 


DM 


IM 


TAG(7) 

1 


TAG(6) 

1 


TAG(5) 

1 


TAG(4) 

1 


TAG(3) 

1 


TAG(2) 

1 


TAG(1) 

I 


TAG(0) 

1 


16LSB 


4 MSB 





INSTRUCTION OPCODE 


16LSB 


4 MSB 






STATUS WORD 
CONTROLWORD 
TAG WORD FORMAT 

INSTRUCTION ADDRESS 
DATA ADDRESS 



"RESERVED 



Figure 6-2. 8087 Environment 



Status Word 

The status word reflects the overall condition of the 8087; it may be examined by 
storing it into memory with an 8087 instruction and then inspecting it with 
8086/8088 CPU code. The status word is divided into the exception flag and status 
bit fields shown in figure 6-3. The busy field (bit 15) indicates whether the 8087 is 
executing an instruction (B=l) or is idle (B=0), 

Several 8087 instructions (e.g., comparison instructions) result in modification of 
the condition code. The condition code is contained in bits 14 and 10-8 (C3-C0) of 
the status word. The condition code is used mainly for conditional branching. See 
the following instruction descriptions later in this chapter for condition code inter- 
pretations: FCOM, FCOMP, FCOMPP, FTST, FXAM and FPREM. 

Bits 13-11 of the status word points to the 8087 stack element that is the current 
stack top (ST). Note that if ST=000B, a "push" operation which decrements ST, 
produces ST=1 1 IB; similarly, popping the stack with ST=1 1 IB yields ST=000B. 

Bit 7 (IR) is the interrupt request field. The 8087 latches this bit to record a pending 
interrupt to the 8086/8088 CPU. 

Bits 5-0 (PE, UE, OE, EE, DE, and IE) are set to indicate that the 8087 has detected 
an exception while executing an instruction. 
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B 


C3 


ST 
' 1 


C2 


C1 


CO 


IR 




PE 


UE 


OE 


ZE 


DE 


"I 



L 



EXCEPTION FLAGS (1 = EXCEPTION HAS OCCURRED) 

INVALID OPERATION 

DENORMALIZED OPERAND 

ZERODIVIDE 

OVERFLOW 

UNDERFLOW 

PRECISION 
(RESERVED) 
INTERRUPT REQUEST 
CONDITION CODEID 
STACK TOP POINTER* 2 ' 
BUSY 



Figure 6-3 . Status Word Format 



121623-10 



ST values 



000 = element is stack top 

001 = element 1 is stack top 



111= element 7 is stack top 



Control Word 

The control word consists of the exception masks, an interrupt enable mask, and 
control bits as shown in figure 6-4. During the execution of most instructions, the 
8087 checks for six classes of exception conditions: 

1. Invalid operations — programming errors such as trying to load a floating point 
stack element that is not empty, popping an operand from an element that is 
empty, using operands that cause indeterminate results (0/0, square root of a 
negative number, trying to store an unnormalized number which will not denor- 
malize, etc.). 

2. Overflow— usually the exponent of the true result is too large for the destination 
real format. 



3. 



5. 
6. 



Underflow — the true exponent is too small to be represented in the result 
format. 

Zerodivide — division of a finite non-zero operand by zero. 

Denormalized — an instruction attempts to operate on a denormalized number. 

Precision — for instructions that perform exact arithmetic, this exception means 
that some precision has been lost in reporting the results of an operation. 



When one of these six conditions occurs, the corresponding flag in the status word is 
set to 1. The 8087 checks the appropriate mask in the Control Word to determine if 
it should process the exception with a default handling procedure on chip (mask = 1) 
or invoke a user written exception handler (mask = 0). 

In the first case, the exception is said to be MASKED (from user software). 
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I , , 


IC 


RC 

■ 


PC 


IEM 




PM 


UM 


OM 


ZM 


DM 


IM 1 



L 



EXCEPTION MASKS (1 = EXCEPTION IS MASKED) 

INVALID OPERATION 

DENORMALIZED OPERAND 

ZERODIVIDE 

OVERFLOW 

UNDERFLOW 

PRECISION 
(RESERVED) 
CONTROL BITS 
INTERRUPT-ENABLE MASK* 1 ) 
PRECISION CONTROL^) 
ROUNDING CONTROLS 
INFINITY CONTROL^ 
(RESERVED) 



C> Interrupt-Enable Mask: 

= Interrupts Enabled 

1 = Interrupts Disabled (Masked) 
( 2 ) Precision Control: 

00 = 24 bits 

01 = (reserved) 

10 = 53 bits 

11 = 64 bits 
Rounding Control: 

00 = Round to Nearest or Even 

01 = Round Down (toward «>) 

10 = Round Up (toward •■-•») 

11 = Chop (Truncate Toward Zero) 
Infinity Control: 

= Projective 

1 = Affine 



(3) 



W 



Figure 6-4. Control Word Format 



121623-11 



The control bits have the following meanings: 

PC: Precision control — results are rounded to one of three 

precisions: Temporary Real (64 bits), Long Real (53 bits) or 
Short Real (24 bits). 

RC: Rounding Control — results are rounded in one of four 

directions: unbiased round to the nearest or even value, round 
toward +, round toward -, or round toward zero. 

IC: Infinity Control — there are two types of infinity arithmetic 

provided: affine and projective. The default means of closing a 
Number system is projective. See The 8086 Family User's 
Manual, Numerics Supplement, for a complete description. 



Tag Word 

The tag word, as shown in figure 6-5, contains tags describing the contents of the 
corresponding stack elements. 
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7 









1 TAG(7) 


TAG(6) 


TAG(5) 

1 


TAG (4) 

L 


TAG(3) 


TAG(2) 
1 


TAG(1) 

L,_ 


TAG(O) 
I 



Tag values: 

00 = Valid (Normal or Unnormal) 

01 = Zero (True) 

10 = Special (Not-A-Number, °°, or Denormal) 

11 = Empty 



Figure 6-5. Tag Word Format 



OPERAND ADDRESS^) 

| INSTRUCTION OPCODE^) 



INSTRUCTION ADDRESS< 1 > 



10 

(1) 20-bit physical address 
* 2 ) 11 least significant bits of opcode; 5 most significant bits are always 8087 hook (1101 1 B) 



Figure 6-6. Exception Pointers Format 



Exception Pointers 

The exception pointers shown in figure 6-6 are provided for user-written exception 
handlers. Whenever the 8087 executes an instruction, it saves the instruction address 
and the instruction opcode in the exception pointers. In addition, if the instruction 
references a memory operand, the address of the operand is retained also. An excep- 
tion handler can be written to store these pointers in memory and obtain informa- 
tion concerning the instruction that caused the error. 

Data Types 

The 8087 addresses seven different data types using all of the 8086 addressing 
modes. These data types and their valid ranges of value are shown in table 6-5. 

Figure 6-7 describes how these formats are stored in memory (the sign is always 
located in the highest-addressed byte). In the figure, the most significant digits of all 
numbers (and field within numbers) are the leftmost digits. 



Table 6-5. 8087 Data Types 



Data Type 


Bits 


Significant 
Digits (Decimal) 


Approximate Range (Decimal) 


WORD INTEGER 


16 


4-5 


-32768 < x < +32767 


SHORT INTEGER 


32 


9 


-2*10 9 <x<2x10 9 


LONG INTEGER 


64 


18 


-9*10 18 < x<+9x10 18 


PACKED DECIMAL 


80 


18 


-99. ..99 < x < +99. ..99 (18 digits) 


SHORT REAL 


32 


6-7 


0, 1.2x10~ 38 < |x| ^3.4x10 38 


LONG REAL 


64 


15-16 


0, 2.3x10~ 308 < | x | <1.7*10 308 


TEMPORARY REAL 


30 


19-20 


0,3.4x10~ 4932 < |x| < 1.1 x 10 4932 
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WORD INTEGER 



15 



INCREASING SIGNIFICANCE 



MAGNITUDE 



(TWO'S 
COMPLEMENT) 



SHORT INTEGER IS 



MAGNITUDE 



(TWO'S 
COMPLEMENT) 



63 



LONG INTEGER IS 



PACKED DECIMAL 



79 



MAGNITUDE 



(TWO'S 
COMPLEMENT) 



MAGNITUDE 



I "6 | °5 | °4 | °3 | °2 | °1 | 



shortreal|s| ex b $sed t 



LONG REAL Is 



63 



TEMPORARY REAL IS 



79 



SIGNIFICAND 



^ 

N| — I A 



BIASED 
EXPONENT 



52\ 

^— I A 



BIASED | . 

EXPONENT |] 



64 63' 



SIGNIFICAND 



SIGNIFICAND 



NOTES: 

S = Sign bit (0 = positive, 1 = negative) 

d n = Decimal digit (two per byte) 

X = Bits have no significance; 8087 ignores when loading, zeros when storing. 

A = Position of implicit binary point 

I = Integer bit of significand; stored in temporary real, implicit in short and long real 

Exponent Bias (normalized values): 

Short Real: 127 (7FH) 

Long Real: 1023 (3FFH) 

Temporary Real: 16383 (3FFFH) 



Figure 6-7. Data Formats 



The three binary integer formats are identical except for length, which governs the 
range that can be accommodated in each format. The leftmost bit is interpreted as 
the number's sign: = positive and 1 = negative. Negative numbers are represented 
in standard two's complement notation (the binary integers are the only 8087 format 
to use two's complement). The quantity zero is represented with a positive sign (all 
bits 0). The 8087 word integer format is identical to the 16-bit signed integer data 
type of the 8086 and 8088. 

Decimal integers are stored in packed decimal notation, with two decimal digits 
"packed" into each byte. Negative numbers are distinguished from positive ones 
only by the sign bit. All digits must be in the range 0H-9H. 

The 8087 stores real numbers in a three-field binary format that resembles scientific 
notation. The number's significant digits are held in the SIGNIFICAND field, the 
EXPONENT field locates the binary point within the significant digits (determining 
the number's magnitude), and the SIGN field indicates whether the number is 
positive or negative. Negative numbers differ from positive numbers only in their 
sign bit. 
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The short and long real formats exist only in memory. If a number in one of these 
formats is loaded into the stack, it is automatically converted to temporary real. 

Special values are included to increase flexibility though not within the domain of 
normal floating point arithmetic. These special values are listed here, but the reader 
is referred to The 8086 Family User's Manual, Numerics Supplement, for descrip- 
tions. The special values include: 

Signed zero 

+°° and -oo representations 

Indefinite values 

NAN values (Not-A-Number) 

Denormals 

Unnormals 



8087 Operation 
Coprocessing 

The 8087 and host CPU act as coprocessors. They share the same instruction stream 
and sometimes perform parallel executions. The 8086/8088 has a set of ESCAPE 
instructions that, in memory addressing mode, cause the 8086/8088 to calculate the 
address and read the contents of that address. The 8086/8088 ignores the word it 
reads and executes subsequent instructions. The 8087, however, monitors the same 
instruction stream and when it detects an ESCAPE it begins processing. The 8087 
latches the opcode and, if there was an address calculated, the 8087 captures both 
the address and the datum read by the 8086/8088. The 8087 decodes the instruction 
to determine how many more words it needs from memory. It increments the 
address and fetches data until all required data is read. The 8087 then releases the 
bus and begins calculating while the 8086/8088 continues executing the instruction 
stream. 

The 8086/8088 WAIT instruction allows software to synchronize the 8086/8088 to 
the 8087 so that the host processor does not execute the next instruction until the 
8087 is finished with its current (if any) instruction. To accomplish this, the pro- 
grammer should explicitly code the FWAIT instruction immediately before an 
8086/8088 instruction that accesses a memory operand read or written by a previous 
8087 instruction. 

If an 8087 and a processor other than its host CPU can both update a variable, 
access to that variable should be controlled so that one processor at a time has 
exclusive rights to it. This can be done by using an 8086/8088 XCHG instruction 
prefixed by LOCK. When the 8087 no longer needs the variable, the 8086/8088 
clears it and again makes it available for use. 

The 8087 interrupt requests are made to the 8086/8088 as the result of detecting an 
exception. Interrupts are enabled or disabled by the Interrupt Enable Mask (IEM) in 
the Control Word. When IEM is set to 1, interrupts are masked (disabled). The 
interrupt request remains set until it is explicitly cleared. This can be done by the 
FNCLEX, FNSAVE, or FINIT instructions. 

Numeric Processing 

The 8087 has four rounding modes, selectable by the RC field in the control word. 
The rounding modes and their corresponding RC fields are shown in table 6-6. 
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Table 6-6. Rounding Modes 



RC Field 


Rounding Mode 


Rounding Action 


00 


Round to nearest 


Closer to b of a or c; if equally close, select 
even number (the one whose least significant 
bit is zero). 


01 


Round down (toward -<») 


a 


10 


Round up (toward +°°) 


c 


11 


Chop (toward 0) 


Smaller in magnitude of a ore 



Note: a <b <c;a andc are representable, b is not. 



Rounding occurs in arithmetic and store operations when the format of the destina- 
tion cannot exactly represent the true result. This can happen when a precise tem- 
porary real number is stored in a shorter real format or in an integer format. Round- 
ing introduces an error in a result that is less than one unit in the last place to which 
the result is rounded. "Round to the nearest significant bit" is the default mode and 
is suitable for most applications. Other modes and applications are described in The 
8086 Family User's Manual, Numerics Supplement. 

The precision of results can be calculated to 64, 53, or 24 bits as selected by the PC 
field of the control word. The default setting is 64 bits. This setting is best suited for 
most applications. 

The 8087 's system of real numbers may be closed by either of two models of infinity. 
The IC field in the control word is set for either projective or affine closure. The 
default is projective, which is recommended for most computations. Both closure 
forms and their uses are described in The 8086 Family User's Manual, Numerics 
Supplement. 

The 8087 can represent data and final results of calculations in the range 
±2.3xlO -308 to ±1.7xl0 308 (double precision). Compared to most computers, 
including large mainframes, the 8087 provides a very good approximation of the real 
number system. It is important to remember, however, that it is not an exact 
representation, and that arithmetic on real numbers is inherently approximate. 

Conversely, and equally important, the 8087 does perform exact arithmetic on its 
integer subset of the reals. That is, an operation on two integers returns an exact 
integral result, provided that the true result is an integer and is in range. 

The 8087 detects the six types of exceptions shown in table 6-7. The programmer has 
a choice of using the 8087 on-chip fault-handling capability by masking exceptions 
in the Control Word, or writing software exception handlers and unmasking excep- 
tions in the control word. Table 6-3 shows the 8087 response to each situation. 

If the exception is unmasked, its detection results in the generation of an interrupt. 
When an interrupt is generated, the interrupt procedure (exception handler) has 
available the exception flags, a pointer to the instruction causing the interrupt and a 
pointer to the datum if memory was addressed. Each of the exceptions shown in 
table 6-7 has a sticky flag associated with it, which means that once the flag is set, it 
remains until reset by software. Several instructions can be used to clear the flag: 
FCLEX clears exceptions; FRSTOR or FLDENV overwrite flags. 

Those users who wish to write their own exception handlers should consult The 8086 
Family User's Manual, Numerics Supplement since they will vary widely from one 
application to the next. 
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Table 6-7. Exception and Response Summary 



Exception 


Masked Response 


Unmasked Response 


Invalid 
Operation 


If one operand is NAN**, return it; 
if both are NANS, return NAN with 
larger absolute value; if neither is 
NAN, return indefinite. 


Request interrupt. 


Zerodivide 


Return °° signed with "exclusive 
or" of operand signs. 


Request interrupt. 


Denormalized 


Memory operand: proceed as 
usual. Register operand: convert to 
valid unnormal, then re-evaluate 
for exceptions. 


Request interrupt. 


Overflow 


Return properly signed °°. 


Register destination: adjust 
exponent,* store result, request 
interrupt. Memory destination: 
request interrupt. 


Underflow 


Denormalize result. 


Register destination: adjust 
exponent,* store result, request 
interrupt. Memory destination: 
request interrupt. 


Precision 


Return rounded result. 


Return rounded result, request 
interrupt. 



On overflow, 24,576 decimal is subtracted from the true result's exponent; this forces the 
exponent back into range and permits a user exception handler to ascertain the true result 
from the adjusted result that is returned. On underflow, the same constant is added to the 
true result's exponent. 

NAN is a member of a class of special values that exist in the real formats only. See the The 
8086 Family User's Manual, Numerics Supplement. 



8087 Emulators 

Numeric processing capability is not restricted to 8087 users. Intel offers two 
8086/8088 software products which provide 8087 functionality. E8087 emulates the 
full 8087 instruction set for assembly language programs. PE8087 furnishes numeric 
support for PL/M-86 software. Use of the 8087 Emulators necessitates modification 
of the instruction formats presented in this chapter. 

ASM86, the Intel 8086/8087/8088 assembler, produces special object code for 8087 
instructions. Floating point instructions are identified in such a way that they may 
be linked to the 8087 Emulators. Refer to the 8086/8087/8088 Assembler Operating 
Instructions for ISIS-II User's manual for a short description of this change and link 
procedure. 



Organization of the 8087 Instruction Set 



Data Transfer Instructions 

These instructions are summarized in table 6-8. They move operands among stack 
elements or between the stack top and memory. Any of the seven data types can be 
converted to temporary real and loaded (pushed) onto the stack in a single opera- 
tion; they can be stored in memory in the same manner. The data transfer instruc- 
tions automatically update the 8087 tag word to reflect the stack contents following 
the instruction. 
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Table 6-8. Data Transfer Instructions 





Real Transfers 


FLD 
FST 
FSTP 
FXCH 


Load real 
Store real 
Store real and pop 
Exchange registers 




Integer Transfers 


FILD 
FIST 
FISTP 


Integer load 
Integer store 
Integer store and pop 




Packed Decimal Transfers 


FBLD 
FBSTP 


Packed decimal (BCD) load 
Packed decimal (BCD) store and pop 



Arithmetic Instructions 

The arithmetic instruction set for the 8087 provides a great many variations on the 
basic add, subtract, multiply and divide operations, and a number of other useful 
functions. Table 6-9 gives a summary of these instructions. 

Table 6-9. Arithmetic Instructions 





Addition 


FADD 


Add real 


FADDP 


Add real and pop 


FIADD 


Integer add 




Subtraction 


FSUB 


Subtract real 


FSUBP 


Subtract real and pop 


FISUB 


Integer subtract 


FSUBR 


Subtract real reversed 


FSUBRP 


Subtract real reversed and pop 


FISUBR 


Integer subtract reversed 




Multiplication 


FMUL 


Multiply real 


FMULP 


Multiply real and pop 


FIMUL 


Integer multiply 




Division 


FDIV 


Divide real 


FDIVP 


Divide real and pop 


FIDIV 


Integer divide 


FDIVR 


Divide real reversed 


FDIVRP 


Divide real reversed and pop 


FIDIVR 


Integer divide reversed 




Other Operations 


FSQRT 


Square root 


FSCALE 


Scale 


FPREM 


Partial remainder 


FRNDINT 


Round to integer 


FXTRACT 


Extract exponent and significand 


FABS 


Absolute value 


FCHS 


Change sign 
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The stack element form is a generalization of the classical stack form; the program- 
mer specifies the stack top as one operand and any stack element on the stack as the 
other operand. Coding the stack top as the destination provides a convenient way to 
make use of a constant held elsewhere in the stack. The converse coding (ST is the 
source operand) allows, for example, adding the top into a stack element used as an 
accumulator. 

Often the operand in the stack top is needed for one operation but then is of no fur- 
ther use in the computation. The stack element and pop form can be used to pick up 
the stack top as the source operand, and then discard it by popping the floating 
point stack. Coding operands of ST(1),ST with a stack element pop mnemonic is 
equivalent to a classical stack operation: the top is popped and the result is left at the 
new top. 

Programmers no longer need to spend valuable time eliminating square roots from 
algorithms because processors run too slowly. Other arithmetic instructions perform 
exact modulo division, round real numbers to integers, and scale values by powers 
of two. 

The 8087's arithmetic instructions (addition, subtraction, multiplication, and divi- 
sion) allow the programmer to minimize memory references and to make optimum 
use of the 8087 floating-point stack. 

Table 6-10 summarizes the available operation/operand forms that are provided for 
basic arithmetic. In addition to the four normal operations, two "reversed" 
instructions make subtraction and division "symmetrical" like addition and 
multiplication. 

• Operands may be located in stack elements or memory. 

• Results may be deposited in a choice of stack elements. 

• Operands may be a variety of 8087 data types: long real, short real, short integer 
or word integer, with automatic conversion to temporary real performed by the 
8087. 

Five instruction forms may be used across all six operations, as shown in table 6-10. 
The classical stack form may be used to make the 8087 operate like a classical stack 
machine. No operands are coded in this form, only the instruction mnemonic is 
coded. The 8087 picks the source operand from the stack top and the destination 
from the next stack element. It then performs the operation, pops the stack, and 
returns the result to the new stack top, effectively replacing the operands by the 
result. 



Table 6-10. Basic Arithmetic Instructions and Operands 


Instruction Form 


Mnemonic 
Form 


Operand Forms 
destination, source 


ASM86 Example 


Classical stack 


Fop 


{ST(1),ST} 


FADD 


Stack element 


Fop 


ST(i),STorST,ST(i) 


FSUB ST,ST(3) 


Stack element 
and pop 


FopP 


ST(i),ST 


FMULP ST(2),ST 


Real memory 


Fop 


{ST,} short-real/long-real 


FDIV AZIMUTH 


Integer memory 


Flop 


{ST,} word-integer/short-integer 


FIDIV N_PULSES 



Notes: Braces { > surround implicit operands; these are not coded, and are shown here for 
information only. 



op 



ADD 

SUB 

SUBR 

MUL 

DIV 

DIVR 



destination 
destination 
destination 
destination 
destination 
destination 



destination + source 
destination - source 
source -destination 
destination ■ source 
destination + source 
source -^destination 
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The two memory forms increase the flexibility of the 8087's arithmetic instructions. 
They permit a real number or a binary integer in memory to be used directly as a 
source operand. This is a very useful facility in situations where operands are not 
used frequently enough to justify holding them in the floating point stack. Note that 
various forms of data allocation may be used to define these operands; they may be 
elements in arrays, structures or other data organizations, as well as simple scalars. 

The six functional groups of instructions are discussed further in the next 
paragraphs. 



Comparison Instructions 

Each of these instructions (table 6-1 1) analyzes the top stack element, often in rela- 
tionship to another operand, and reports the result in the status word condition 
code. The basic operations are compare, test (compare with zero), and examine 
(report tag, sign, and normalization). Special forms of the compare operation are 
provided to optimize algorithms by allowing direct comparisons with binary integers 
and real numbers in memory, as well as popping the stack after a comparison. 

The FSTSW (store status word) instruction may be used following a comparison to 
transfer the condition code to memory for inspection. See individual descriptions of 
the instructions listed in table 6-1 1 for interpretations of the condition code bits. 

Note that instructions other than those in the comparison group may update the 
condition code. To ensure that the status word is not altered inadvertently, it should 
be stored immediately after the compare operation. 



Table 


6-11. 


Comparison Instructions 


FCOM 




Compare real 


FCOMP 




Compare real and pop 


FCOMPP 




Compare real and pop twice 


FICOM 




Integer compare 


FICOMP 




Inteqer compare and pop 


FIST 




Test 


FXAM 




Examine 



Transcendental Instructions 

The instructions in this group are summarized in table 6-12. They perform the core 
calculations for all common trigonometric, inverse trigonometric, hyperbolic, 
inverse hyperbolic, logarithmic and exponential functions. Prologue and epilogue 
software may be used to reduce arguments to the range accepted by the instructions 
and to adjust the result to correspond to the original arguments if necessary. The 
transcendentals operate on the top one or two stack elements, and they return their 
results to the stack, 



Table 6-12. 


Transcendental Instructions 


FPTAN 


Partial tangent 


FPATAM 


Partial arctangent 


F2XM1 


2 X -1 


FYL2X 


Y*log 2 X 


FYL2XP1 


Y*log 2 (X + 1) 
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The transcendental instructions assume that their operands are valid and in-range. 
The instruction descriptions in this section provide the range of each operation. To 
be considered valid, an operand to a transcendental must be normalized; denormals, 
unnormals, infinities and NANs are considered invalid. Zero operands are accepted 
by some functions and are considered out-of-range by others. If a transcendental 
operand is invalid or out-of-range, the instruction will produce an undefined result 
without signaling an exception. It is the programmer's responsibility to ensure that 
operands are valid and in-range before executing a transcendental. FPREM may be 
used to bring an operand into range for periodic functions. 



Constant Instructions 

Each of these instructions (table 6-13) loads (pushes) a commonly-used constant 
onto the stack. The values have full temporary real precision (64 bits) and are 
accurate to approximately 19 decimal digits. Since a temporary real constant 
occupies 10 memory bytes, the constant instructions, which are only two bytes long, 
save storage and improve execution speed, in addition to simplifying programming. 



Table 6-13. 


Constant Instructions 


FLDZ 


Load + 0.0 


FLD1 


Load + 1 .0 


FLDPI 


Load n 


FLDL2T 


Load log 2 10 


FLDL2E 


Load log2e 


FLDLG2 


Load log 1 Q2 
Load log e 2 


FLDLN2 



Processor Control Instructions 

When CPU interrupts are enabled, as will normally be the case when an application 
task is running, the "wait" forms of these instructions should be used. Most of the 
instructions shown in table 6-14 are used in system-level activities rather than in 
computations. These activities include: initialization, exception handling, and task 
switching. 



Alternate mnemonics are shown for several of the processor control instructions in 
table 6-14. This mnemonic, distinguished by a second character of "N", instructs 
the assembler not to prefix the instruction with a CPU WAIT instruction (instead, a 
CPU NOP precedes the instruction). This "no-wait" form is intended for use in 
critical code regions where a WAIT instruction might precipitate an endless wait. 
Thus, when CPU interrupts are disabled, and the 8087 can potentially generate an 
interrupt, the "no-wait" form should be used. 



Except for FNSTENV and FNSAVE, all instructions which provide a no-wait 
mnemonic are self-synchronizing and can be executed back-to-back in any combina- 
tion without intervening FWAITs. These instructions can be executed by one part of 
the 8087 while the other part is busy with a previously decoded instruction. To 
ensure that the processor control instruction executes after completion of any opera- 
tion in progress, the "WAIT" form of that instruction should be used. 
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Table 6-14. 


Processor Control Instructions 


FINIT/FNINIT 


Initialize processor 


FDISI/FNDISI 


Disable interrupts 


FENI/FNENI 


Enable interrupts 


FLDCW 


Load control word 


FSTCW/FNSTCW 


Store control word 


FSTSW/FNSTSW 


Store status word 


FCLEX/FNCLEX 


Clear exceptions 


FSTENV/FNSTENV 


Store environment 


FLDENV 


Load environment 


FSAVE/FNSAVE 


Save state 


FRSTOR 


Restore state 


FINCSTP 


Increment stack pointer 


FDECSTP 


Decrement stack pointer 


FFREE 


Free register 


FNOP 


No operation 


FWAIT 


CPU wait 
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Sample 8087 Instruction 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



1 an offset value (either 8 or 16 bits) 

modrm byte (middle 3 bits part of opcode) 



opcode (possibly two bytes) 



an 8086 wait instruction, NOP, or emulator instruction 



8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


(the 8087 


(emulator 


typical 


(machine operation) 


MNEMONIC 


instruction 


instruction 


range 






coding) 


coding) 









Operation 

(A description of the machine operation.) 

Exceptions 

I Z D U P 

(shows which exceptions could be set) 
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F2XM1 



2 X -1 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9F0 


CD19F0 


500 


ST - 2 ST -1 


F2XM1 






310-630 









Operation 

This instruction calculates the function Y = 2 X — 1. X is taken from the top of the 
floating point stack and must be in the range < X < 0.5. The result Y replaces X at 
the stack top. 



Exceptions 

I Z D U P * 
X X 

^Operands not checked. 



Description 

This instruction is designed to produce a very accurate result even when x is close to 
zero. To obtain Y = 2 X , add 1 to the result delivered by F2XM1 . 

The following formulas show how values other than 2 may be raised to a power of 
X. 

10 x = 2 x*log 2 10 
qX — 2X * log 2 e 
yx = 2 X * lo 92y 

The 8087 has built-in instructions, described in this chapter, for loading the con- 
stants LOG2 10 and LOG2 e, and the FYL2X instruction may be used to calculate X 
*log 2 Y. 
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Absolute Value 



Format 



WAIT 


op1 


op2 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 


BD9E1 


CD19E1 


14 
10-17 



Operation 



ST - | ST | 



Coding Example 



FABS 



Operation 

The absolute value instruction changes the element in the top of the stack to its ab- 
solute value by making its sign positive. 



Exceptions 

I Z D U P 
X 
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FADD 



Add Real 



Format 












Stack top + Stack element 










WAIT 


op1 


0p2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8C0+i 


CD18C0 + i 


85 
70-100 


ST *- ST + ST(i) 


FADD ST,ST(2) 


9BDCC0 + i 


CD1CC0 + i 


85 


ST(i) «- ST + ST(i) 


FADD ST(4),ST 






70-100 









Stack top + memory operand 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m0rm 


CD18m0rm 

( 


105 + EA 
30-120) + EA 


ST «- ST + mem-op 
(short-real) 


FADD COUNT 


9BDCm0rm 


CDICmOrm 


110 + EA 


ST *- ST + mem-op 


FADD MEAN 




( 


35-125) + EA 




(long-real) 





Operation 

The add real instruction adds the source operand to the destination operand and 
places the result in the destination. The source operand may be either the stack top, 
a stack element, or a short or long real operand in memory. When the source is the 
stack top, the destination is one of the stack elements. When the source is a stack ele- 
ment or memory operand, the destination is the stack top. 



Exceptions 

I Z D U P 
X X X X X 
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Add Real and Pop 

Format 

Stack top + Stack Element 



WAIT 


op1 


Op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDEC1 


GD1EC1 


90 
75-105 


ST(1)«-ST + ST(1) 
pop stack 


FADD 


9BDEC0 + i 


CD1EC0 + 1 


90 


ST(i) - ST + ST(i) 


FADDP ST(2),ST 






75-105 




pop stack 





Operation 

The add real and pop stack instruction adds the stack top to one of the stack elements, 
replacing the stack element with the sum, and then pops the floating point stack. 



Exceptions 

J Z D U P 
X X X X X 
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FBLD 



Packed Decimal (BCD) Load 



Format 



WAIT 


op1 


m/op/rm 


addM 


addr2 






Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Cod 


9BDFm4rm 


CDIFm4rm 


300 +EA 


push stack 


FBL 




(290-31 0)+EA 


ST *- mejm-op 





Coding Example 



FBLD YTD SALES 



Operation 

The BCD load instruction converts the memory operand from packed decimal to 
temporary real and pushes the result onto the stack. The sign of source is preserved, 
including the case when the value is negative zero. 



Exceptions 

I Z D U P 
X 



Note 

The packed decimal digits of the source are assumed to be in the range 
0-9H. The instruction does not check for invalid digits (A-FH) and the 
result of attempting to load an invalid encoding is undefined. 
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Packed Decimal (BCD) Store and Pop 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 






Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BDFm6rm 


CDIFm6rm 


530 +EA 


mem-op — ST 


FBSTP FORECAST 




(520-540) + EA 




pop stack 





Operation 

The packed decimal store and pop stack instruction converts the contents of the 
stack top to a packed decimal integer, stores the result at the destination in memory, 
and pops the floating point stack. 



Exceptions 

I Z D U P 
X 



Note 

FBSTP produces a rounded integer from a non-integral value by adding 0.5 
to the value and then deleting least significant bits. 

Users who are concerned about rounding may precede FBSTP with FRNDINT. 
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FCHS 



Change Sign 



Format 



WAIT 


op1 


0p2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9E0 


CD19E0 


15 


ST - -ST 


FCHS 






10-17 









Operation 

The change sign instruction complements the sign on the stack top element. 

Exceptions 

I Z D U P 
X 
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Clear Exceptions 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


S3 DB E2 


CD1BE2 


5 
2-8 


clear 8087 exceptions 


FCLEX 


90 DB E2 


CD1BE2 


5 


clear 8087 exceptions 


FNCLEX 






2-8 




(no wait) 





Operation 

This instruction clears all exception flags, the interrupt request flag and the busy flag 
in the status word. As a consequence, the 8087's INT and BUSY lines go inactive. 
The FCLEX form of this instruction is preceded by an assembler-generated WAIT 
instruction. 



Exceptions 



I Z D U P 



Description 

FNCLEX is used in critical areas of code where a WAIT instruction might result in a 
deadlock. FCLEX is used to insure that the processor control instruction executes 
only after completion of any operation in progress in the NOP. 
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FCOM 



Compare Real 



Format 












Compare Stack top and Stack element 








WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8D1 


CD18D1 


45 
40-50 


ST-STO) 


FCOM 


9BD8D0 + i 


CD18D0 + i 


45 


ST - ST(i) 


FCOM ST(2) 






40-50 









Compare Stack top and memory operands 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m2rm 


CD18m2rm 


65+ EA 
60-70) + EA 


ST - memop 
(short-real) 


FCOM WAVELE 


9BDCm2rm 


CD1Cm2rm 


70+EA 


ST - memop 


FCOM MEAN 






65-75) + EA 




(long-real) 





Operation 

The compare real instruction compares the stack top with the source operand. The 
source operand may be a stack element or short or long real memory operand. If no 
operand is coded. ST is compared with ST(1). 



Exceptions 

I Z D U P 
X X 



Description 

Following the instruction, the condition codes in the 8087 status byte reflect the 
order of the operands as follows: 



C3 



C2 



ORDER 


















1 


1 








1 


1 


1 



ST > source 
ST< source 
ST = source 
ST? source 
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Note 

NANs and °° (projective) cannot be compared and return C3 = CO = 1 as 
shown above. 

The following procedures can be used to store the status word from this instruction 
and test the compare result. 

The condition code can be transferred from the 8087 status byte to memory, an 8086 
register, or the 8086 flags register. For example, the code required to transfer the 
information to the flags register is: 



FSTSW STAT_87 

FWAIT 

MOV AH, BYTE PTR STAT_87+1 

SAHF 



STORE RESULT FROM FCOM 

WAIT FOR STORE 

MOVE STATUS BYTE TO AH 

LOAD INTO 8086 FLAGS REGISTER 



The 8086 instructions are now used to execute a conditional branch on the result of 
the compare as follows: 



JB 

JBE 

JA 

JAE 

JE 

JNE 



JUMP if ST 

JUMP IF ST 

JUMP IF ST 

JUMP IF ST 



JUMP IF ST = 



source 
source 
source 
source 
source 



OR ST ? 
OR ST ? 
and NOT 
and NOT 
or ST ? 



source 

source 

ST ? source 

ST ? source 

source 



JUMP IF ST * source and NOT ST ? source 
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FCOMP 



Compare Real and Pop 



Format 

Compare Stack top and Stack element and pop 



WAIT 


op1 


op2+i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8D9 


CD18D9 


47 
42-52 


ST-STO) 
pop stack 


FCOMP 


9BD8D8+i 


CD18D8+i 


47 


ST-ST(i) 


FCOMP ST(3) 






42-52 




pop stack 





Compare Stack top and memory operand and pop 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m3rm 


CD18m3rm 

( 


68+EA 
63-73) + EA 


ST - mem-op 
pop stack 
(short-real) 


FCOMP DENSITY 


9BDCm3rm 


CD1Cm3rm 

( 


72 + EA 
67-77) + EA 


ST - mem-op 
pop stack 


FCOMP PERCENT 










(long-real) 





Operation 

The compare real and pop stack instruction compares the stack top with the source 
operand and then pops the floating point stack. The source operand may be a stack 
element or short or long real memory operand. If no operand is coded, ST is com- 
pared with ST(1). 



Exceptions 

I Z D U P 
X X 
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Description 

Following the instruction, the condition codes in the 8087 status byte reflect the 
order of the operands as follows: 



C3 



C2 



CO 



ORDER 


















1 


1 








1 


1 


1 



ST> source 
ST< source 
ST = source 
ST? source 



Note 

NANs and °° (projective) cannot be compared and return C3 = CO = 1 as 
shown above. 



The following procedures can be used to store the status word from this instruction 
and test the compare result. 

The condition code can be transferred from the 8087 status byte to memory, an 8086 
register, or the 8086 flags register. For example, the code required to transfer the 
information to the flags register is: 



FSTSW STAT_87 

FWAIT 

MOV AH, BYTE PTR STAT_87+1 

SAHF 



STORE RESULT FROM FCOM 

WAIT FOR STORE 

MOVE STATUS BYTE TO AH 

LOAD INTO 8086 FLAGS REGISTER 



The 8086 instructions are now used to execute a conditional branch on the result of 
the compare as follows: 



JB 

JBE 

JA 

JAE 

JE 

JNE 



JUMP if ST 

JUMP IF ST 

JUMP IF ST 

JUMP IF ST 



JUMP IF ST = 



source 
source 
source 
source 
source 



OR ST ? 
OR ST ? 
and NOT 
and NOT 
or ST ? 



source 

source 

ST ? source 

ST ? source 

source 



JUMP IF ST # source and NOT ST ? source 
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FCOMPP 



Compare Real and Pop Twice 



Format 



WAIT 


op1 


Op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDED9 


CD1ED9 


50 
45-55 


ST-ST(1) 
pop stack 


FCOMPP 










pop stack 





Operation 

The compare real and pop stack twice instruction compares the stack top with ST(1) 
and pops the floating point stack twice, discarding both operands. No operands may 
be explicitly coded with this instruction. 



Exceptions 

I Z D U P 
X X 

Description 

Following the instruction, the condition codes in the 8087 status byte reflect the 
order of the operands as follows: 



C3 



C2 



CO 



ORDER 


















1 


1 








1 


1 


1 



ST> source 
ST< source 
ST = source 
ST? source 



Note 

NANs and °° (projective) cannot be compared and return C3 = CO = 1 as 
shown above. 



The following procedures can be used to store the status word from this instruction 
and test the compare result. 

The condition code can be transferred from the 8087 status byte to memory, an 8086 
register, or the 8086 flags register. For example, the code required to transfer the 
information to the flags register is: 



FSTSW STAT_87 

FWAIT 

MOV AH, BYTE PTR STAT_87+1 

SAHF 



STORE RESULT FROM FCOM 

WAIT FOR STORE 

MOVE STATUS BYTE TO AH 

LOAD INTO 8086 FLAGS REGISTER 



6-135 



FCOMPP 



ASM86 



The 8086 instructions are now used to execute a conditional branch on the result of 
the compare as follows: 



JB 

JBE 

JA 

JAE 

JE 

JNE 



JUMP if ST 

JUMP IF ST 

JUMP IF ST 

JUMP IF ST 



source 
source 
source 
source 



OR ST ? 
OR ST ? 
and NOT 
and NOT 



source 
source 
ST ? source 
ST ? source 



JUMP IF ST = source or ST ? source 
JUMP IF ST * source and NOT ST ? source 



6-136 



ASM86 



FDECSTP 



Decrement Stack Pointer 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9F6 


CD19F6 


9 
6-12 


stack pointer — 2 
stack pointer -1 


FDECSTP 



Operation 

This instruction subtracts 1 from the stack top pointer in the status word. No tags or 
registers are altered, nor is any data transferred. Executing FDECSTP when the 
stack top pointer is 0, changes the pointer to 7. 



Exceptions 



I Z D U P 



6-137 



FDISI 
FNDISI 



ASM86 



Disable Interrupts 



Format 



WAIT 


op1 


Op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding 


9BDBE1 


CD1BE1 


5 
2-8 


Set 8087 interrupt mask 


FDISI 


90 DB E1 


CD1BE1 


5 


Set 8087 interrupt mask 


FNDISI 






2-8 




(no wait) 





Operation 

The instruction sets the interrupt enable mask in the control word and prevents the 
NDP from issuing an interrupt request. The FDISI form of this instruction is 
preceded by an assembler-generated WAIT. 



Exceptions 



I Z D U P 



Description 

The NO WAIT form of the instruction (FNDISI) is intended for use in critical code 
regions where a WAIT instruction might induce an endless wait. 



Note 

If WAIT is decoded with pending exceptions, the 8087 generates an 
interrupt — masked or not. 



6-138 



ASM86 



FDIV 



Divide Real 

Format 

Stack top and Stack element 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8F0+i 


CD18F0 + i 


198 
193-203 


ST*-ST/ST(i) 


FDIV ST,ST(2) 


9BDC F8 + i 


CD1CF8 + i 


198 


ST(i)--ST(i)/ST 


FDIV ST(3),ST 



193-203 



Stack top and memory operand 



WAIT 


op1 


m/op/rm 


| addn 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m6rm 


CD18m6rm 


220 + EA 
(21 5-225) + EA 


ST*- ST/ mem-op 
(short-real) 


FDIV DISTANCE 


9BDCm6rm 


CD1Cm6rm 


225+ EA 


ST *- ST/mem-op 


FDIV GAMMA 






(2 


20-230) + EA 


(long-real) 





Operation 

The divide real instructions divide the destination by the source and return the quo- 
tient to the destination. The source operand may be either the stack top, a stack ele- 
ment, or a short or long real operand in memory. When the source is the stack top, 
the destination is one of the stack elements. When the source is a stack element or 
memory operand, the destination is the stack top. 

The divide real and pop stack instruction divides one of the stack elements by the 
stack top, replaces the stack element with the quotient, and then pops the floating 
point stack. 



Exceptions 

I Z D U P 
X X X X X X 



6-139 



FDIVP 



ASM86 



Divide Real and Pop 



Format 



WAIT 


op1 


op2+i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDEF9 


CD1EF9 


202 
197-207 


ST(1)-ST(1)/ST 
pop stack 


FDIV 


9BDEF8+i 


CD1EF8+i 


202 


ST(i)-ST(i)/ST 


FDIVP ST(3),ST 






197-207 




pop stack 





Operation 

The divide real instructions divide the destination by the source and return the quo- 
tient to the destination. The source operand may be either the stack top, a stack ele- 
ment, or a short or long real operand in memory. When the source is the stack top, 
the destination is one of the stack elements. When the source is a stack element or 
memory operand, the destination is the stack top. 

The divide real and pop stack instruction divides one of the stack elements by the 
stack top, replaces the stack element with the quotient, and then pops the floating 
point stack. 



Exceptions 

I Z D U P 
X X X X X X 



6-140 



ASM86 



FDIVR 



Divide Real Reversed 

Format 

Stack top and Stack element 



WAIT 


op1 


op2 + i 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD8F8 + i 


CD18F8 + i 


199 
194-204 


ST-ST(i)/ST 


FDIVR ST,ST(2) 


9BDCF0 + i 


CD1CF0 + i 


199 


ST(i)-ST/ST(i) 


FDIVR ST(3),ST 



194-204 



Stack top and memory operand 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D8 m7rm 


CD18m7rm 


221 + EA 
(216-226) + EA 


ST^- mem-op/ST 
(short-real) 


FDIVR RATE 


9BDCm7rm 


CD1C m7rm 


226 +EA 
(221-231) + EA 


ST — mem-op/ST 
(long-real) 


FDIVR SPEED 


Operation 















The divide real reversed instructions divide the source operand by the destination 
and return the quotient to the destination. The source operand may be either the 
stack top, a stack element,, or a short or long real operand in memory. When the 
source is the stack top, the destination is one of the stack elements. When the source 
is a stack element or memory operand, the destination is the stack top. 

The reverse divide and pop stack instruction divides the stack top by one of the stack 
elements and returns the quotient to the stack element. The floating point stack is 
then popped. 



Exceptions 

I Z D U P 
X X X X X X 



6-141 



FDIVRP 



ASM86 



Divide Real Reversed and Pop 



Format 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDEF1 


3D1EF1 


203 
198-208 


ST(1)-ST/ST(1) 
pop stack 


FDIVR 


9BDEF0 + i 


3D1EF0 + 1 


203 


ST(i)-ST/ST(i) 


FDIVRP ST(4),ST 






198-208 









Operation 

The divide real reversed instructions divide the source operand by the destination 
and return the quotient to the destination. The source operand may be either the 
stack top, a stack element, or a short or long real operand in memory. When the 
source is the stack top, the destination is one of the stack elements. When the source 
is a stack element or memory operand, the destination is the stack top. 

The reverse divide and pop stack instruction divides the stack top by one of the stack 
elements and returns the quotient to the stack element. The floating point stack is 
then popped. 



Exceptions 

I Z D U P 
X X X X X X 



6-142 



ASM86 



FENI 
FNENI 



Enable Interrupts 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Codinc 


9BDBE0 


CD1BE0 


5 
2-8 


clear 8087 interrupt mask 


FENI 


90 DB E0 


CD1BE0 


5 


clear 8087 interrupt mask 


FNENI 






2-8 




(no wait) 





Operation 

This instruction clears the interrupt enable mask in the control word, allowing the 
8087 to generate interrupt requests. The FENI form of this instruction is preceded 
by an assembler-generated WAIT instruction. 



Exceptions 



I Z D U P 



Description 

The NO WAIT form of the instruction (FNENI), is intended for use in critical code 
regions where a WAIT instruction might induce an endless wait. 

The WAIT form of this instruction (FENI), should be used in all non-critical code 
regions. This form insures that the processor control instruction executes after com- 
pletion of any operation in progress in the NEU. 



6-143 



FFREE 



ASM86 



Free Register 



Format 



WAIT 


op1 


op2 + i 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BDDC0 + i 


CD1DC0 + i 


11 


TAG(i) masked empty 


FFREE ST(1) 






9-16 









Operation 

This instruction changes the destination stack element's tag to empty. The contents 
of this stack element are unaffected. 



Exceptions 



I Z D U P 



6-144 



ASM86 



FIADD 



Integer Add 



Format 



WAIT 


op1 


m/op/rm 


addM 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDAm0rm 


CDIAmOrm 


125+EA 
(108-1 43) + EA 


ST «- ST + mem-op 
(short integer) 


FIADD DISTANCE 


9BDEm0rm 


CDIEmOrm 


120 + EA 


ST — ST + mem-op 


FIADD PULSE 






(102-1 37) + EA 




(word integer) 





Operation 

This instruction adds the integer memory source to the top of the stack and returns 
the sum to the destination at the top of the stack. 



Exceptions 

I Z D U P 
X XX X 



6-145 



FICOM 



ASM86 



Integer Compare 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 



Operation 



Coding Example 



9BDAm2rm CD1Am2rm 85 + EA ST - mem-op 

(78-91) + EA (short integer) 

9BDEm2rm CD1Em2rm 80 + EA ST -mem-op 

(72-86) + EA (word integer) 



FICOM PASSES 



FICOM CENTS 



Operation 

The integer compare instructions convert the memory operand (a word or short 
binary integer) to temporary real and compare it with the top of the stack. 



Exceptions 

I Z D U P 
X X 



Description 

Following the instruction, the condition codes in the 8087 status byte reflect the 
order of the operands as follows: 



C3 



C2 



CO 



ORDER 


















1 


1 








1 


1 


1 



ST> source 
ST< source 
ST = source 
ST? source 



Note 

NANs and °° (projective) cannot be compared and return C3 = CO = 1 as 
shown above. 



The following procedures can be used to store the status word from this instruction 
and test the compare result. 

The condition code can be transferred from the 8087 status byte to memory, an 8086 
register, or the 8086 flags register. For example, the code required to transfer the 
information to the flags register is: 



FS.TSW STAT_87 

FWAIT 

MOV AH, BYTE PTR STAT_87+1 

SAHF 



STORE RESULT FROM FICOM 

WAIT FOR STORE 

MOVE STATUS BYTE TO AH 

LOAD INTO 8086 FLAGS REGISTER 



6-146 



ASM86 



FICOM 



The 8086 instructions are now used to execute a conditional branch on the result of 
the compare as follows: 



JB 

JBE 

JA 

JAE 

JE 

JNE 



JUMP 
JUMP 
JUMP 
JUMP 
JUMP 



if 
IF 
IF 
IF 
IF 



ST 
ST 
ST 
ST 
ST 



source 
source 
source 
source 
source 



OR ST ? 
OR ST ? 
and NOT 
and NOT 
or ST ? 



source 

source 

ST ? source 

ST ? source 

source 



JUMP IF ST * source and NOT ST ? source 



6-147 



FICOMP 



ASM86 



Integer Compare and Pop 

Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDAm3rm 


CD1Am3rm 


87 + EA 


ST - mem-op 


FICOMP LIMIT 




(80-93) + EA 


pop stack 










(short integer) 




9BDEm3rm 


CD1Em3rm 


82 + EA 


ST- mem-op 


FICOMP SAMPLE 




(74-88) + EA 


pop stack 










(word integer) 




Operation 













The integer compare instructions convert the memory operand (a word or short 
binary integer) to temporary real and compare it with the top of the stack. FICOMP 
additionally discards the value in ST by popping the floating point stack. 

Exceptions 

I Z D U P 
X X 



Description 

Following the instruction, the condition codes in the 8087 status byte reflect the 
order of the operands as follows: 



C3 



C2 



CO 



ORDER 


















1 


1 








1 


1 


1 



ST > source 
ST< source 
ST = source 
ST? source 



Note 

NANs and °° (projective) cannot be compared and return C3 = CO = 1 as 
shown above. 

The following procedures can be used to store the status word from this instruction 
and test the compare result. 

The condition code can be transferred from the 8087 status byte to memory, an 8086 
register, or the 8086 flags register. For example, the code required to transfer the 
information to the flags register is: 



FSTSW STAT_87 

FWAIT 

MOV AH, BYTE PTR STAT_87+1 

SAHF 



STORE RESULT FROM FICOMP 

WAIT FOR STORE 

MOVE STATUS BYTE TO AH 

LOAD INTO 8086 FLAGS REGISTER 



6-148 



ASM86 



FICOMP 



The 8086 instructions are now used to execute a conditional branch on the result of 
the compare as follows: 



JB 

JBE 

JA 

JAE 

JE 

JNE 



JUMP 
JUMP 
JUMP 
JUMP 
JUMP 



if 
IF 
IF 
IF 
IF 



ST 
ST 
ST 
ST 
ST 



source 
source 
source 
source 
source 



OR ST ? 
OR ST ? 
and NOT 
and NOT 
or ST ? 



source 

source 

ST ? source 

ST ? source 

source 



JUMP IF ST * source and NOT ST ? source 



6-149 



FIDIV 



ASM86 



Integer Divide 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 



Operation 



Coding Example 



9BDAm6rm CD1Am6rm 236 + EA ST - ST/ mem-op 

(230-243) + EA (short integer) 

9BDEm6rm CD1Em6rm 230 + EA 



(224-238) +EA 



ST *- ST/mem-op 
(word integer) 



FIDIV SURVEY 



FIDIV ANGLE 



Operation 

The integer divide instruction divides the top of the stack by the integer memory 
operand and returns the quotient to the top of the stack. 



Exceptions 

I Z D U P 
X X X X X X 



6-150 



ASM86 



FIDIVR 



Integer Divide Reversed 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 
Typical Operation 

Range 


Cod 



3 



Coding Example 



9BDAm7rm CD1Am7rm 237 + EA ST - mem-op /ST 

(231-245) + EA (short integer) 

9BDEm7rm CD1Em7rm 230 + EA ST-mem-op/ST 

(225-239) + EA (word integer) 



FIDIVR COORD 



FIDIVR FREQUENCY 



Operation 

The reversed integer divide instruction divides the integer memory operand by the 
top of the stack and returns the quotient to the stack top. 



Exceptions 

I Z D U P 
X X X X X X 



6-151 



FILD 



ASM86 



Integer Load 



Format 



WAIT 



op1 



m/op/rm 



addh 



add 



13 



8087 Emulator 

Encoding Encoding 



9BDBm0rm CDIBmOrm 



9BDFm0rm CDIFmOrm 



9BDFm5rm CD1Fm5rm 



Execution 
Clocks 

Typical 


Operation 


Coding Example 


Range 






56+EA 


push stack 


FILD STANDOFF 


(52-60) + EA 


ST — mem-op 
(short integer) 




50 + EA 


push stack 


FILD SEQUENCE 


(46-54) + EA 


ST — mem-op 
(word integer) 




64 + EA 


push stack 


FILD RESPONSE 


(60-68) + EA 


ST *- mem-op 
(long integer) 





Operation 

The integer load instruction converts the integer memory operand from its binary 
integer format (word, short, or long) to temporary real and pushes the result onto 
the stack. The new stack top is tagged zero if all bits in the source were zero, and is 
tagged valid otherwise. 



Exceptions 

I Z D U P 
X 



6-152 



ASM86 



FIMUL 



Integer Multiply 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDAm1rm 


CD1Am1rm 


136+ EA 


ST — ST * mem-op 


FIMUL BEARING 




(130-1 44) + EA 


(short integer) 




9BDEm1rm 


CD1Em1rm 


130+EA 


ST — ST * mem-op 


FIMUL POSITION 



Operation 

The integer multiply instruction multiplies the integer memory operand and the top 
of the stack and returns the product to the top of the stack. 



Exceptions 

I Z D U P 
X XX X 



6-153 



FINCSTP 



ASM86 



Increment Stack Pointer 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9F7 


CD19F7 


9 
6-12 


stack pointer «- 
stack pointer + 1 


FINCSTP 



Operation 

The stack pointer increment instruction adds 1 to the stack top pointer in the status 
word. It does not alter tags or register contents, nor does it transfer data. It is not 
equivalent to popping the stack since it does not set the tag of the previous stack to 
empty. Incrementing a stack pointer of 7 changes it to 0. 



Exceptions 



I Z D U P 



6-154 



ASM86 



FINIT 
FNINIT 



initialize Processor 



Format 



WAIT 


op1 


Op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDBE3 


CD1BE3 


5 
2-8 


initialize 8087 


FINIT 


90DBE3 


CD1BE3 


5 
2-8 


initialize 8087 
(no wait) 


FNINIT 


Operation 













The initialize processor instruction performs the functional equivalent of a hardware 
RESET, except that it does not affect the instruction fetch synchronization of the 
8087 and its CPU. FINIT/FNINIT sets the control word to 03FFH, empties all 
floating point stack elements, and clears exception flags and busy interrupts. The 
FINIT form of this instruction is preceded by an assembler-generated WAIT 
instruction. 



Exceptions 



I Z D U P 



Note 



The system should call the INIT87 procedure in lieu of executing 
FINIT/FNINIT when the processor is first initialized, for compatability 
with the 8087 emulator. 



6-155 



FIST 



ASM86 



Integer Store 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B DB m2rm 


CD 1B m2rm 


88+EA 
82-92) + EA 


mem-op *- ST 
(short integer) 


FIST COUNT 


9B DF m2rm 


CD 1F m2rm 


86+EA 


mem-op — ST 


FIST FACTOR 




( 


80-90) + EA 




(word integer) 





Operation 

The integer store instruction rounds the contents of the stack top to an integer 
(according to the RC field of the control word) and transfers the result to the 
memory destination. The destination may define a word or short integer variable. 
Negative zero is stored in the same encoding as positive zero: 0000... 00. 



Exceptions 

I Z D U P 
X X 



6-156 



ASM86 



FISTP 



Integer Store and Pop 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B DB m3rm ( 


2D 1B m3rm 


90 + EA 
84-94) + EA 


mem-op *- ST 
pop stack 
(short integer) 


FISTP CORRECTE 


9B DF m3rm 


3D 1Fm3rm 


88 + EA 
82-92) + EA 


mem-op *- ST 
pop stack 
(word integer) 


FISTP ALPHA 


9B DF m7rm 


3D 1F m7rm 


100 + EA 


mem-op *- ST 


FISTP READINGS 




(94-105) + EA 


pop stack 












(long integer) 





Operation 

The integer store and pop stack instruction rounds the contents of the stack top to 
an integer (according to the RC field of the control word) and transfers the result to 
the memory destination. The floating point stack is popped following the transfer. 
The destination may be any of the binary integer data types. 



Exceptions 

I Z D U P 
X X 



6-157 



FISUB 



ASM86 



Integer Subtract 



Format 



WAIT 


op1 


m/op/rm 


addn 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDAm4rm 


CD1A m4rm 


125+EA 


ST — ST - mem-op 


FISUB BASE 




(108-1 43) + EA 


(short integer) 




9BDEm4rm 


CD1Em4rm 


120 + EA 


ST «- ST - mem-op 


FISUB SIZE 



Operation 

This instruction subtracts the integer memory operand from the top of the stack and 
returns the difference to the top of the stack. 



Exceptions 

I Z D U P 
X XX X 



6-158 



ASM86 



FISUBR 



Integer Subtract Reversed 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 



Operation 



Coding Example 



9BDAm5rm CD1Am5rm 125+ EA ST *- mem-op - ST 

(109-144) + EA (short integer) 

9BDEm5rm CD1Em5rm 120 + EA ST «- mem-op - ST 

(103-1 39) + EA (word integer) 



FISUBR FLOOR 



FISUBR BALANCE 



Operation 

The integer subtract reversed instruction subtracts the stack top from the integer 
memory source and returns the difference to the stack top. 



Exceptions 

I Z D U P 
X XX X 



6-159 



FLD 



ASM86 



Load Real 

Format 

Stack element to Stack top 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9C0+1 


CD19C0 + i 


20 
17-22 


T, - ST(i) 

push stack 
ST-T, 


FLD ST(2) 



Memory operand to Stack top 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 



8087 
Encoding 



Emulator 
Encoding 



Execution 
Clocks 
Typical 
Range 



Operation 



Coding Example 



9BD9m0rm CD19m0rm 



9BDDm0rm CDIDmOrm 



9BDBm5rm CD1Bm5rrn 



43+ EA 
(38-56) + EA 

46+EA 
(40-60) + EA 

57+EA 
(53-65) + EA 



push stack 
ST *- mem-op 
(short real) 

push stack 
ST «- mem-op 
(long real) 

push stack 
ST *- mem-op 
(temp real) 



FLD READING 



FLD TEMPERATURE 



FLD SAVEREADING 



Operation 

The load real instruction pushes the source operand onto the top of the floating 
point stack. This is done by decrementing the stack pointer by one and then copying 
the contents of the source to the new stack top. The source may be a stack element 
on the stack (ST(i)), or any of the real data types in memory. Short and long real 
source operands are converted to temporary real automatically. Executing FLD 
ST(0) duplicates the old stack top in the new stack top. 



Exceptions 

I Z D U P 
X X 



6-160 



ASM86 



FLDCW 



Load Control Word 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 






Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 


Operation 


Cod 






Range 









3 



Coding Example 



9BD9m5rm CD19m5rm 



10 + EA processor control word FLDCW CONTROL 

(7-14) + EA — mem-op 



Operation 

This instruction replaces the current processor control word with the word defined 
by the source operand. 



Exceptions 

I Z D U P 

Description 

This instruction is typically used to establish, or change, the 8087's mode of 
operation. 



Note 

If an exception bit in the status word is set, loading a new control word that 
unmasks that exception and clears the interrupt enable mask will generate 
an immediate request before the next instruction is executed. When chang- 
ing modes, the recommended procedure is to first clear any exceptions and 
then load the new control word. 



6-161 



FLDENV 



ASM86 



Load Environment 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 



8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


9BD9m4rm 


CD19m4rm 


40 + EA 


8087 environment 






(35-45) + EA 


mem-op 



Coding Example 



FLDENV ENV_STORE 



Operation 

The load environment instruction reloads the 8087 environment from the memory 
area defined by the source operand. This data should have been written by a 
previous FSTENV/FNSTENV instruction. 



Exceptions 

I Z D U P 

Description 

CPU instructions may immediately follow FLDENV, but no subsequent NDP 
instruction should be executed without an intervening FWAIT or assembler- 
generated WAIT. 



Note 

Loading an environment image that contains an unmasked exception causes 
an immediate interrupt request from 8087 (assuming IEM = in the envi- 
ronment image). 



6-162 



ASM86 



FLDLG2 



Load Log 10 2 



Format 



WAIT 


op1 


0p2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 EC 


CD 19 EC 


21 
18-24 


push stack 
ST-log 10 2 


FLDLG2 



Operation 

The load log base 10 of 2 instruction pushes the value logio2 onto the top of the 
floating point stack. The constant has temporary real precision of 64 bits and 
accuracy of approximately 19 decimal digits. 



Exceptions 

I Z D U P 
X 



6-163 



FLDLN2 



ASM86 



Load Log e 2 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 ED 


CD19ED 


20 
17-23 


push stack 
ST *- log e 2 


FLDLN2 


Operation 













The load log base e of 2 instruction pushes the value log e 2 onto the top of the 
floating point stack. This constant has temporary real precision of 64 bits with an 
accuracy of approximately 19 decimal digits. 



Exceptions 

I Z D U P 
X 



6-164 



ASM86 



FLDL2E 



Load Log 2 e 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9EA 


CD19EA 


18 
15-21 


push stack 
ST *- log 2 e 


FLDL2E 


Operation 













The load log base 2 of e instruction pushes the value log2e onto the top of the 
floating point stack. This value has full temporary real precision of 64 bits. 



Exceptions 

I Z D U P 
X 



6-165 



FLDL2T 



ASM86 



Load Log 2 10 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9E9 


CD19E9 


19 
16-22 


push stack 
ST*-log 2 10 


FLDL2T 


Operation 













The load log base 2 of 10 instruction pushes the constant Iog2l0 onto the stack. This 
constant has temporary real precision of 64 bits with accuracy of approximately 19 
decimal digits. 



Exceptions 

I Z D U P 
X 



6-166 



ASM86 



FLDPI 



Load re 












Format 












WAIT 


op1 


0p2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9EB 


CD19EB 


19 
16-22 


push stack 

ST «- n 


FLDPI 



Operation 

This instruction pushes n onto the top of the stack. The n value has full temporary 
real precision of 64 bits with an accuracy of approximately 19 decimal digits. 



Exceptions 

1 Z D U P 
X 



6-167 



FLDZ 



ASM86 



Load +0.0 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9EE 


CD19EE 


14 
11-17 


push stack 
ST*- 0.0 


FLDZ 



Operation 

The load zero instruction pushes the value +0.0 onto the top of the floating point 
stack. The constant has temporary real precision of 64 bits. 



Exceptions 

I Z D U P 
X 



6-168 



ASM86 



FLD1 



Load +1.0 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9B D9 E8 


CD19EE8 


18 
15-21 


push stack 
ST - 1 .0 


FLD1 



Operation 

This instruction pushes the constant +1.0 onto the top of the floating point stack. 
This constant has full temporary real precision of 64 bits. 



Exceptions 

I Z D U P 
X 



6-169 



FMU 



ASM86 



Multiply Real 

Format 

Stack top and Stack element 



WAIT 


op1 


Op2+i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8C8 + i 


CD18C8+i 


138* 
130-145* 


ST«-ST*ST(i) 


FMUL ST,ST(3) 


9BDCC8 + i 


DD1CC8 + i 


138* 


ST(i) *- ST(i) * ST 


FMUL ST(2),ST 






130-145* 









97 
*Clocks are when one or both operands are short. 

90-105 



Stack top and memory operand 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 



8087 Emulator 

Encoding Encoding 



Execution 
Clocks 
Typical Operation 

Range 



Coding Example 



9BD8m1rm CD18m1rm 



118 + EA ST -ST* mem-op 

(110-125) + EA (short real) 



9BDCm1rm CD1Cm1rm 161 + EA* ST - ST * mem-op 

(154-168) + EA* (long real) 



FMUL SPEED 



FMUL HEIGHT 



'Clocks are when one or both operands are short. 

(112-126) + EA 



Operation 

The multiply real instruction multiplies the destination operand by the source and 
returns the product to the destination. The source operand may be either the stack 
top, a stack element, or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 



Exceptions 

I Z D U P 
X X X X X 



6-170 



ASM86 



FMULP 



Multiply Real and Pop 



Format 



WAIT 


op1 


op2 + i 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9B DE C8 + i 


CD1EC8 + i 


142* 


ST(i) - ST(i) * ST 


FMULP ST(2),ST 






134-148* 




pop stack 





"Clocks are when one or both operands are short. 

94-108 



Operation 

The multiply real instruction multiplies the destination operand by the source and 
returns the product to the destination. The source operand may be either the stack 
top, a stack element, or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 

The multiply real and pop stack instruction multiplies one of the stack elements by 
the stack top, replaces the stack element with the product, and then pops the floating 
point stack. 



Exceptions 

I Z D U P 
X X X X X 



6-171 



FNOP 



ASM86 



No operation 



Format 



WAIT 


op1 


op2 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 


9B D9 DO 


CD 19 DO 


13 
10-16 


Operation 







Operation 



ST -ST 



Coding Example 



FNOP 



This operation stores the stack top to the stack top and thus effectively performs no 
operation. 



Exceptions 



I Z D U P 



6-172 



ASM86 



FPATAN 



Partial Arctangent 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 F3 


CD19F3 


650 
250-800 


T^arctaniSKD/ST) 
pop stack 

ST - 1\ 


FPATAN 



Operation 

The partial arctangent instruction computes the function = ARCTAN (Y/X). X is 
taken from the top stack element and Y from ST(1). Y and X must observe the 
inequality 0<Y<X< + °°. The instruction pops the floating point stack and 
returns to the new stack top, overwriting the Y operand. 



Exceptions 

I Z D U P * 
X X 

"operands not checked 



Description 

This instruction assumes that the operands are valid and in-range. To be considered 
valid, an operand must be normalized. If an operand is either invalid or out-or- 
range, the instruction will produce an undefined result without signalling an 
exception. 



6-173 



FPREM 



ASM86 



Partial Remainder 

Format 



WAIT 


op1 


op2 








Execution 




8087 


Emulator 


Clocks 




Encoding 


Encoding 


Typical 
Range 


Operation 


9BD9F8 


CD19F8 


125 
15-190 


ST-REPE 


Operation 











Coding Example 



This instruction performs modulo division on the stack top by ST(1). FPREM pro- 
duces an EXACT result; the precision exception does not occur. The sign of the 
remainder is the same as the sign of the original dividend. 

Exceptions 

I Z D U P 
XXX 

Description 

FPREM operates by performing successive subtractions. It can reduce a magnitude 
difference of up to 2 64 in one execution. If FPREM produces a remainder that is less 
than the modulus (ST(1)), the function is complete and bit C2 of the status word 
condition code is cleared. If the function is incomplete, C2 is set to 1; the result in ST 
is then called the partial remainder. 

Software can be used to inspect C2 by storing the status word following execution of 
FPREM and re-executing the instruction (using the partial remainder in ST as the 
dividend), until C2 is cleared. An alternate possibility is comparing ST to ST(1) to 
determine when the function is complete. If ST > ST(1), FPREM must be executed 
again. If ST = ST(1), the remainder is and execution is complete. If ST < ST(1), ex- 
ecution is complete and the remainder is ST. 

Note 

A context switch between the instructions in the remainder loop can be 
forced by a higher priority interrupting routine which needs the 8087. 

One important use of FPREM is to reduce arguments (operands) of periodic 
transcendental functions to the range permitted by these instructions. For example, 
the FPTAN (tangent) instruction requires its argument to be less than tt/4. Using n/4 
as a modulus, FPREM will reduce an argument so that it is in the range of FPTAN. 
Because FPREM produces an exact result, the argument reduction does NOT intro- 
duce roundoff error into the calculations even if several iterations are required to 
bring the argument into range. The rounding of n produces a rounded period rather 
than a rounded argument. 

FPREM also provides the least-significant three bits of the quotient generated by 
FPREM (in C 3 , C,, C ). This is also important for transcendental argument reduc- 
tion since it locates the original angle in the correct one of eight tt/4 segments of the 
unit circle. 



6-174 



ASM86 



FPTAN 



Partial Tangent 



Format 



WAIT 


op1 


op2 




8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


9B D9 F2 


CD19F2 


450 
30-540 


Y/X *- TAN (ST) 

ST-Y 

push stack 
ST«-X 



Coding Example 



FPTAN 



Operation 

The partial tangent instruction computes the function Y/X = TAN(0). is taken 
from the top stack element. The value of must be within the range < = < ir/4. 
The result of the operation is a ratio; y replaces in the stack and X is pushed, 
becoming the new stack top. is measured in radians. 



Exceptions 

I Z D U P * 
X X 

"operands not checked 

Description 

The ratio result of FPTAN is designed to optimize the calculation of the other 
trigonometric functions. 

This instruction assumes that the operand is valid and in-range; to be considered 
valid, an operand must be normalized. If the operand is invalid or out-of-range, the 
instruction will produce an undefined result without signalling an exception. 



6-175 



FRNDINT 



ASM86 



Round to Integer 



Format 



WAIT 


op1 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9B D9 FC 


CD19FC 


45 


ST «- nearest integer (ST) 


FRNDINT 






16-50 









Operation 

This instruction rounds the top stack element to an integer. 

Exceptions 

I Z D U P 
X X 



Description 

Assume that ST contains the 8087 real number encoding of the decimal value 
155.625. FRNDINT will change the value to 155 if the RC field of the control word 
is set to down or chop; or to 156 if it is set to up or nearest. 



6-176 



ASM86 



FRSTOR 



Restore Saved State 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



J 



8087 
Encoding 



Emulator 
Encoding 



Execution 
Clocks 

Typical 

Range 



Operation 



Coding Example 



9B DD m4rm CD 1 D m4rm 202 + EA 8087 state - mem-op 

(197-207) + EA 



FRSTOR STATE„SAVE 



Operation 

The restore state instruction reloads the 8087 from the 94-byte memory area defined 
by the source operand. This information should have been written by a previous 

FSAVE/FNSAVE instruction. 



Exceptions 



I Z D U P 



Note 

CPU instructions may immediately follow FRSTOR, but no NDP instruc- 
tion should be executed without an intervening FWAIT or an assembler- 
generated WAIT. 

The 8087 resets to its new state at the conclusion of the FRSTOR. The 8087 will, for 
example, generate an immediate interrupt request if indicated by the exception and 
mask bits in the memory image. 



6-177 



FSAVE 
FNSAVE 



ASM86 



Save State 



Format 



WAIT 



op1 



m/op/rm 



addrl 



addr2 



3 







Execution 


8087 


Emulator 


Clocks 


Encoding 


Encoding 


Typical 
Range 



Operation 



Coding Example 



9BDDm6rm CD1Dm6rm 202 + EA mem-op «- 8087 state 

(197-207) + EA 

90 DD m6rm CD 1 D m6rm 202 + EA mem-op - 8087 state 

(197-207) + EA (no wait) 



FSAVE STATE^SAVE 



FNSAVE STATE 



Operation 

The save state instruction writes the full 8087 state— environment plus register 
stack — to the memory location specified in the destination operand, and initializes 
the NDP. The FSAVE form of this instruction is preceded by an assembler- 
generated WAIT instruction. 



Exceptions 



I Z D U P 



Description 

Figure 6-8 shows the 94-byte save area layout. Typically, FSAVE/FNSAVE will be 
coded to save this image on the CPU stack. 

If an instruction is executing in the 8087 when FNSAVE is decoded, the CPU queues 
the save and delays its execution until the running instruction completes normally, 
or encounters an unmasked exception. The save image, therefore, reflects the state 
of the 8087 following completion of any running instruction. After writing the state 
image to memory, FSAVE/FNSAVE initializes the 8087 as if FINIT/FNINT had 
been executed. 

FSAVE/FNSAVE is useful whenever a program wants to save the current state of 
the NDP and initialize it for a new routine. Three examples are: 

1. An operating system needs to perform a context switch (suspend the task that 
has been running and give control to a new task); 

2. An interrupt handler needs to use the 8087; 

3. An application task wants to pass a "clean" 8087 stack to a sub-routine. 



6-178 



ASM86 



FSAVE 
FNSAVE 



INCREASING ADDRESSES 





15 







+ 

+ 2 ' 




CONTROLWORD 




STATUS WORD 




TAG WORD 


+ 4 


INSTRUCTION J 


IP15-0 


+ 6 


POINTER A 


IP19-16 





OPCODE 


+ 8 


OPERAND J 


OP15-0 


+ 10 


POINTER ] 


OP19-16 





+ 12 


r 


SIGNIFICAND15-0 


+ 14 




SIGNIFICAND 31-16 


+ 16 


TOP STACK J 
EL.EMENT-.ST \ 


SIGNIFICAND 47-32 


+ 18 




SIGNIFICAND 63-48 
i 


+ 20 


< 


sl EXPONENT 14-0 


+ 22 


r 


SIGNIFICAND 15-0 


+ 24 




SIGNIFICAND 31-16 


+ 26 


NEXT STACK J 
ELEMENT:ST(1) \ 


SIGNIFICAND 47-32 


+ 28 




SIGNIFICAND 63-48 
i 


+ 30 


^ 


S EXPONENT 14-0 


+ 32 








r 


SIGNIFICAND 15-0 


+ 84 




SIGNIFICAND 31-16 


+ 86 


LAST STACK J 
ELEMENT:ST(7) "S 


SIGNIFICAND 47-32 


+ 88 




SIGNIFICAND 63-48 
1 


+ 90 


^ 


s| EXPONENT 14-0 


+ 92 



NOTES: 
S = Sign 

Bit of each field is rightmost, least significant bit of corresponding 
register field. 

Bit 63 of significand is integer bit (assumed binary point is immediately 
to the right). 



Figure 6-8. FSAVE/FRSTOR Memory Layout 



121623-15 



Note 

FSAVE/FNSAVE, like FSTENV/FNSTENV, must be protected from any 
other 8087 instruction that might execute while the save is in progress. 
When FSAVE is coded, this can be insured by placing an explicit FWAIT in 
front of a subsequent no-wait mnemonic, if there is one. When FSAVE is 
executed with CPU interupts disabled, an FWAIT should be executed 
before CPU interrupts are enabled or any subsequent 8087 instruction is 
executed. Because the FNSAVE initializes the NDP, there is no danger of 
the FWAIT causing an endless wait. Other CPU instructions may be 
executed between the FNSAVE and the FWAIT; this will reduce interrupt 
latency if the FNSAVE is queued in the 8087. 



6-179 



FSCALE 

Scale 



ASM86 



Format 



WAIT 


opl 


op2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9FD 


CD19FD 


35 


ST«-ST*2 ST(1) 


FSCALE 






32-38 









Operation 

This instruction interprets the value contained in ST(1) as an integer, and adds this 
value to the exponent of the number in ST. ST(1) must be in the range -2' 5 < ST(1) 
< + 2 15 and ST(1) must be an integer. 

Exceptions 

I Z D U P 
X XX 



Description 

FSCALE is particularly useful for scaling the elements of a vector because it pro- 
vides rapid multiplication or division by integral powers of 2. 



Note 

FSCALE assumes the scale factor in ST(1) is an integral value in the range 
-2' 5 < x < 2 15 . If the value is not an integer, but is in-range and is greater in 
magnitude than 1, FSCALE uses the nearest integer smaller in magnitude, 
i.e., it chops the value toward 0. If the value is out of range, or < | x | < 
1, the instruction will produce an undefined result and will not signal an 
exception. The recommended practice is to load the scale factor from a 
word integer to ensure correct operation. 



6-180 



ASM86 



FSQRT 



Square Root 



Format 



WAIT 


op1 


op2 


I 








Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9FA 


CD 19 FA 


183 
180-186 


ST - \AST 


FSQRT 



Operation 

This instruction replaces the contents of the top of the stack with its square root. ST 
must be in the range -0 < ST < + °° . 



Exceptions 

I Z D U P 
XX X 



6-181 



FST 



ASM86 



Store Real 

Format 

Stack top to Stack element 



WAIT 


op1 


op2 + i 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BDDD0 + i 


CD1DD0 + i 


18 


ST(I)*-ST 


FST ST(4) 






15-22 









Stack top to memory operand 



WAIT 


op1 


m/op/rm 


addrl | 


addr2 


I 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Cod 


ng Example 


9BD9m2rm 


CD19m2rm 


87+EA 
84-90) + EA 


mem-op — ST 
(short-real) 


FST 


MEAN 


9B DD m2rm 


CD1Dm2rm 


100+ EA 


mem-op --ST 


FST 


READING 




(96-104) + EA 


(long-real) 






Operation 















The store real instruction transfers the top of the stack to the destination, which may 
be another stack element or a short or long real memory operand. If the destination 
is short or long real, the significand is rounded to the width of the destination 
according to the RC field of the control word and the exponent is converted to the 
width and bias of the destination format. 



Exceptions 

I Z D U P 
X XXX 



Note 

If the stack top is tagged special (it contains °°, a NAN, or a denormal), the 
stack top significand is not rounded. In this case, the least significant bits of 
the stack top are deleted to fit the destination. The exponent is treated in the 
same way. This preserves the value's identification as °°, or a NAN (expo- 
nent of all ones), or a denormal (exponent all zeros) so that it can be prop- 
erly loaded and tagged later in the program, if desired. 



6-182 



ASM86 



FSTCW 
FNSTCW 



Store Control Word 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 m7rm 


CD19m7rm 


15+EA 


mem-op «- processor FSTCW CONTROL 






12-18) + EA 


control word 




90 D9 m7rm 


CD19m7rm 

( 


15+EA 
12-18) + EA 


mem-op «- processc 
control word 


>r FNSTSW CONTRO 










(no wait) 





Operation 

The store control word instructions write the current processor control word to the 
memory location defined by the destination. The FSTCW form of this instruction is 
preceded by an assembler-generated WAIT instruction. 



Exceptions 



I Z D U P 



Description 

When application tasks are running, the WAIT form of this instruction should be 
used. The NO WAIT form is provided for use in critical code regions where a WAIT 
instruction might induce an endless wait. 
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FSTENV 
FNSTENV 



ASM86 



Store Environment 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9m6rm 


CD19m6rm 

( 


45+EA 
40-50) + EA 


mem-op ^8087 

environment 


FSTENV ENVIRON 


90 D9 m6rm 


CD19m6rm 

( 


45+EA 
40-50) + EA 


mem-op *-8087 

environment 


FNSTENV ENVIRON 










(no wait) 





Operation 

This instruction writes the 8087 basic status (control word, status word, and tag 
word) and exception pointers to the memory location defined by the destination 
operand. The FSTENV form of this instruction is preceded by an assembler- 
generated WAIT instruction. 



Exceptions 



I Z D U P 



Description 

FSTENV/FNSTENV is often used by exception handlers because it provides access 
to the exception pointers which identify the offending instruction and operand. 

FSTENV/FNSTENV typically saves the environment on the CPU stack. After the 
environment is saved, FSTENV/FNSTENV sets all exception masks in the pro- 
cessor; it does not affect the interrupt enable mask. Figure 6-9 shows the format of 
the environment data in memory. If FNSTENV is decoded while another instruction 
is executing concurrently in the NEU, the 8087 does not store the environment until 
the other instruction has completed. The data saved by this instruction, therefore, 
reflects the state of the 8087 AFTER any previously decoded instruction has been 
executed. 



Note 

FSTENV/FNSTENV must be allowed to complete before any other 8087 
instruction is decoded. When FSTENV is coded, an assembler-generated 
WAIT should precede any subsequent 8087 instruction. When using 
FNSTENV, with CPU interrupts disabled, an explicit FWAIT should be 
executed before enabling CPU interrupts. 

There is no risk of the FWAIT causing an endless wait. FNSTENV masks 
all exceptions so that interrupt requests from the 8087 are prevented. 



6-184 



ASM86 



FSTENV 
FNSTENV 



INCREASING ADDRESSES 





5 







+ 

+ 2 ' 




CONTROL WORD 




STATUS WORD 




TAG WORD 


+ 4 


INSTRUCTION J 


IP15-0 


+ 6 


POINTER A 


IP19-16 





OPCODE 


+ 8 


OPERAND J 


OP15-0 


+ 10 


POINTER "\ 


OP19-16 





+ 12 



Figure 6-9. FSTENV and FLDENV Memory Layouts 



6-185 



FSTP 



ASM86 



Store Real and Pop 

Format 

Stack top to Stack element 



WAIT 


op1 


op2 + i 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9B DD D8 + i < 


3D1DD8 + i 


20 


ST(i)-ST 


FSTP ST(2) 






17-24 




pop stack 





Stack top to memory operand 



WAIT 


op1 


m/op/rm 


addrl 


I 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 




Coding Example 


9BD9m3rm 


CD19m3rm 

( 


89+EA 
86-92) + EA 


mem-op «- ST 
pop stack 
(short-real) 




FSTP TOTAL 


9BDDm3rm 


3D1Dm3rm 


102 + EA 


mem-op *- ST 




FSTP AVERAGE 




(98-106) + EA 


pop stack 












(long-real) 






9B DB m7rm 


CD 1B m7rm 


55+EA 


mem-op — ST 




FSTP TEMP ST 




(52-58) + EA 


pop stack 














(temp-real) 







Operation 

The store real and pop stack instruction transfers the top of the stack to the destina- 
tion and then pops the stack. The destination may be another stack element, or 
memory operand (short-real, long-real, or temporary-real). If the destination is 
short or long real memory, the significand is rounded to the width of the destination 
according to the RC field of the control word and the exponent is converted to the 
width and bias of the destination format. 

This instruction allows storing temporary real numbers into memory. Coding FSTP 
ST(0) is equivalent to popping the stack with no data transfer. 



Exceptions 

I Z D U P 
X XXX 
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ASM86 



FSTSW 
FNSTSW 



Store Status Word 



Format 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDDm7rm 


CD1[)m7rm 


15 + EA 


mem-op -8087 status FSTSW SAVE_ 






12-18) + EA 


word 




90DDm7rm 


CD1Dm7rm 


15+EA 


mem-op -8087 status FNSTSW SAVE 






12-18) + EA 


word 












(no wait) 





Operation 

The store status word instructions write the current value of the 8087 status word to 
the destination operand in memory. The FSTSW form of this instruction is preceded 
by an assembler-generated WAIT instruction,, 



Exceptions 

1 Z D U P 

Description 

The three primary uses of this instruction are: 

1. To implement conditional branching following a comparison or FPREM 
instruction (WAIT form). 

2. To poll the 8087 to determine if it is busy (NO-WAIT form). 

3. To invoke exception handlers in environments that do not use interrupts (WAIT 
form). 



Note 

If the WAIT form is used with an outstanding unmasked exception, 
deadlock will result. 
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FSUB 



ASM86 



Subtract Real 

Format 

Stack top and Stack element 



WAIT 


op1 


op2 + i 



8087 



Execution 
Emulator Clocks 



Encoding Encoding Typical 

Range 

9BD8E0+i CD18E0 + i 85 

70-100 

9BDCE8+I CD1CE8 + I 85 

70-100 



Operation 

ST - ST - ST(i) 
ST(i) - ST(i) - ST 



Coding Example 

FSUB ST,ST(2) 
FSUB ST(3),ST 



Stack top and memory operand 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m4rm 


CD18m4rm 

( 


105 + EA 
30-120)+EA 


ST *-ST- mem-op 
(short-real) 


FSUB VALUE 


9BDCm4rm 


CD1Cm4rm 


110 + EA 


ST*- ST- mem-op 


FSUB BASE 




( 


35-125) + EA 




(long-real) 





Operation 

The subtract real instruction subtracts the source operand from the destination and 
returns the difference to the destination. The source operand may be either the stack 
top, a stack element or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 



Exceptions 

I Z D U P 
X X X X X 
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ASM86 



FSUBP 



Subtract Real and Pop 



Format 



WAIT 


op1 


op2+i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D8 E8 + i 


CD D8 E8 + i 


90 
75-105 


ST(1)*-ST(1)-ST 
pop stack 


FSUB 


9BDEE8+i 


CD1EE E8+ i 


90 


ST(i)«~ST(i)-ST 


FSUBP ST(2),ST 






75-105 




pop stack 





Operation 

The subtract real instruction subtracts the source operand from the destination and 
returns the difference to the destination. The source operand may be either the stack 
top, a stack element or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 

The subtract real and pop stack instruction subtracts the stack top from one of the 
stack elements, replacing the stack element with the difference and then pops the 
floatingpoint stack. 



Exceptions 

I Z D U P 
X X X X X 
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FSUBR 



ASM86 



Subtract Real Reversed 

Format 

Stack top and Stack element 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D8 E8 + i 


DD D8 E8 + i 


87 
70-100 


ST-ST(i)-ST 


FSUBR ST,ST(i) 


9BDCE0 + i 


CD1CE0+1 


87 


ST(i)*-ST-ST(i) 


FSUBR ST(3),ST 






70-100 









Stack top and memory operand 



WAIT 


op1 


m/op/rm 


addrl 


addr2 | 


8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD8m5rm 


CD18m5rm 

( 


105+EA 
30-120)+ EA 


ST — mem-op - ST 
(short-real) 


FSUBR INDEX 


9BDCm5rm 


CD1Cm5rm 

( 


110+EA 
35-125) + EA 


ST — mem-op - ST 
(long-real) 


FSUBR VECTOR 


Operation 













The reverse subtract instruction subtracts the destination from the source and 
returns the difference to the destination. The source operand may be either the stack 
top, a stack element, or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 
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ASM86 



FSUBRP 



Subtract Real Reversed and Pop 



Format 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BDEE1 


CD1EE1 


90 
75-105 


ST(1)*-ST-ST(1) 
pop stack 


FSUBR 


9BDEE0 + i 


CD1EE0 + i 


90 


ST(i)*-ST-ST(i) 


FSUBRP ST(2),ST 






75-105 




pop stack 





Operation 

The reverse subtract instruction subtracts the destination from the source and 
returns the difference to the destination. The source operand may be either the stack 
top, a stack element, or a short or long real operand in memory. When the source is 
the stack top, the destination is one of the stack elements. When the source is a stack 
element or memory operand, the destination is the stack top. 

The reverse subtract and pop stack instruction subtracts one of the stack elements 
from the stack top and returns the difference to the stack element. The floating 
point stack is then popped. 



Exceptions 

I Z D U P 
X X X X X 
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FTST 



ASM86 



Test Stack Top Against +0.0 



Format 



WAIT 


op1 


0p2 










Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9BD9E4 


CD19E4 


42 


ST -ST -0.0 


FTST 






38-48 









Operation 

The test instruction compares the element in the top of the floating point stack with 
zero and posts the result to the condition code. 



Exceptions 

I Z D U P 
X X 

Description 



C3 



CO 



Condition Code Test Results 
Result 









ST is positive 







1 


ST is negative 




1 





ST is zero (+ or-) 




1 


1 


ST is not comparable (i.e. 


it is a NAN or projective °°) 
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FWAIT 



(CPU) Wait while 8087 is busy 



Format 



WAIT 














Execution 






8087 


Emulator 


Clocks 






Encoding 


Encoding 


Typical 
Range 


Operation 


Coding Example 


9B 


90 


3 + 5n 
3 + 5n 


8086 wait instruction 


FWAIT 



Operation 

This instruction is an alternate mnemonic for the CPU WAIT instruction. FWAIT 
must be used instead of WAIT for 8087 emulator compatability is desired. 



Exceptions 

I Z D U P 



Description 

The FWAIT mnemonic should be coded whenever the programmer wants to syn- 
chronize the CPU to the NDP. This means that further instruction decoding will be 
suspended until the NDP has completed the current instruction. This is useful if the 
CPU wants to inspect a value stored by the NDP (i.e., FIST should be followed by 
FWAIT to ensure that the value has been stored before attempting to examine it). 



Note 

Programmers should not code WAIT to synchronize the CPU and 8087. 
The routines that alter an object program for 8087 emulation change any 
FWAITs to NOPs but do not change any explicitly coded WAITs. The pro- 
gram will wait forever if a WAIT is encountered in emulated execution since 
there is no 8087 to drive the CPU's test pin active. 
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FXAM 



ASM86 



Examine Stack Top 



Format 



WAIT 


op1 


op2 


J 




8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9BD9E5 


CD19E5 


17 
12-23 


set condition code 


FXAM 



Operation 

The examine instruction reports the content of the top of the floating point stack as 
positive/negative and NAN/unnormal/denormal/normal/zero, or empty. The con- 
dition codes which can be generated are shown in table 6-15. 



Exceptions 



I Z D U P 



Description 

Table 6-15 lists and interprets all of the condition code values that FXAM 
generates. Although four different encodings may be returned for an empty register, 
bits C3 and CO of the condition code are both 1 in all encodings. Bits C2 an CI 
should be ignored when examining for empty. 





Table 6-15. FXAM Condition Code Settings 






Condition Code 




Interpretation 


C3 


C2 


C1 


CO 














+ Unnormal 













1 


+ NAN 










1 





- Unnormal 










1 


1 


-NAN 







1 








+ Normal 







1 





1 


+ 0° 







1 


1 





- Normal 







1 


1 


1 


— oo 















+ 












1 


Empty 









1 





-0 









1 


1 


Empty 














+ Denormal 











1 


Empty 








1 





- Denormal 








1 


1 


Empty 
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FXCH 



Exchange Registers 



Format 



WAIT 


op1 


op2 + i 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 C8 


CD19C8 


12 
10-15 


T^STd) 
ST(1)«-ST 
ST-T, 


FXCH 


9BD9C8+i 


CD19C8+i 


12 
10-15 


T, - ST(I) 
ST(i)*-ST 
ST^-T, 


FXCH ST(3) 



Operation 

The exchange instruction swaps the contents of a stack element and the stack top. If 
the stack element is not explicitly coded, ST(1) is used. 



Exceptions 

I Z D U P 
X 

Description 

Many 8087 instructions operate only on the stack top; FXCH provides an easy way 
to use these instructions on lower stack elements. For example, the following 
sequence takes the square root of the third element from the top. 

FXCH ST(3) 

FSQRT 

FXCH ST(3) 
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FXTRACT 



ASM86 



Extract Exponent and Significant! 



Format 



WAIT 


op1 


0p2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 F4 


CD19F4 


50 
27-55 


T, *- exponent (ST) 
T 2 — significand (ST) 
ST-Ti 

push stack 
ST-T ? 


FXTRACT 



Operation 

The extract instruction "decomposes" the number in the stack top into two numbers 
that represent the actual value of the operand's exponent and significand fields. The 
"exponent" replaces the original operand on the stack and the "significand" is 
pushed onto the stack. 



Exceptions 

I Z D U P 
X 

Description 

FXTRACT is useful in conjunction with FBSTP for converting numbers in 8087 
temporary real format to decimal representations (e.g., for printing or displaying). 
It can also be useful for debugging, since it allows the exponent and significand parts 
of a real number to be examined separately. 



Note 

Following execution of FXTRACT, ST (the new stack top), contains the 
value of the original significand expressed as a real number. The sign of this 
number is the same as the operand's; its exponent is true (16,383 or 
3FFFH biased), and its significand is identical to the original operand's. 
ST(1) contains the value of the original operand's true (unbiased) exponent 
expressed as a real number. If the original operand is zero, FXTRACT pro- 
duces zeros in ST and ST(1) and BOTH are signed as the original operand. 



Example 

Assume ST contains a number whose true exponent is +4 (i.e., its exponent field 
contains 4003H). After executing FXTRACT, ST(1) will contain the real number 
+4.0; its sign will be positive, its exponent field will contains 4001+) (+2 true) and its 
significand field will contain 1A00 . . . 00B. In other words, the value in ST(1) will be 
1.0x2 2 = 4. 
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ASM86 



FXTRACT 



If ST contains an operand whose true exponent is -7 (i.e., its exponent field con- 
tains 3FF8H), then FXTRACT will return an "exponent" of -7.0. After the 
instruction executes, ST(l)'s sign and exponent fields will contains C001H (negative 
sign, true exponent of 2) and its significand will be 1A1100 . . . 00B. The value in 
ST(l)willbe-l.llx2 2 = -7.0. 

In both cases, following FXTRACT, ST's sign and significand fields will be the 
same as the original operand's and its exponent field will contain 3FFFH, (0 true). 
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FYL2X 



ASM86 



Y * Log 2 X 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 F1 


CD19F1 


950 
900-1100 


S^-STfD'logjtST) 

pop stack 
ST-T, 


FYL2X 



Operation 

This instruction calculates the function: 

Z = Y*log 2 X 

X is taken from the stack top and Y from ST(1). The operands must be in the ranges 

< X <°° and - °° < Y < + °°. The instruction pops the stack and returns Z at the 
(new) stack top replacing the Y operand. 

Exceptions 

1 Z D U P * 

X 

*operands not checked 



Note 

This function optimizes the calculation of log to any base other than two 
since a multiplication is always required: 



log n x 



log 2 n 



log 2 X 
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FYL2XP1 



Y*Log 2 (X + 1) 



Format 



WAIT 


op1 


op2 






8087 
Encoding 


Emulator 
Encoding 


Execution 
Clocks 

Typical 

Range 


Operation 


Coding Example 


9B D9 F9 


CD19F9 


850 
700-1000 


1 : *- ST + 1 
Tj-SKD'logjT, 


FYL2XP1 










pop stack 





ST *- T, 



Operation 

This instruction calculates the function Z = Y*LOG2 (X + I). X is taken from the 
stack top and must be in the range < | X | < (1- \fl/2). Y is taken from ST(1) 
and must be in the range -°°A < Y <°o. FYL2XP1 pops the floating point stack and 
returns Z at the new stack top, replacing Y. 



Exceptions 

I Z D U P * 
X 

"operands not checked 



Note 

This instruction provides improved accuracy over FYL2X when computing 
the log of a number very close to 1. For example, when calculating 1 + E 
where E « 1, being able to input E rather than 1 + E to the function allows 
more significant digits to be retained. 
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CHAPTER 7 
THE MACRO PROCESSING LANGUAGE 



Introduction 

The Macro Processing Language (MPL) of the 8086/8087/8088 Macro Assembler is 
a string replacement facility. It permits you to write repeatedly used sections of code 
once and then insert that code at several places in your program. If several program- 
mers are working on the same project, a library of macros in include files can be 
developed and shared by the entire team. Perhaps MPL's most valuable capability is 
conditional assembly. Compact configuration-dependent code is often critical to 
microprocessor software design, and conditional assembly of sections of code can 
help to achieve the most compact code possible. 

This chapter documents MPL in three parts. The first section describes how to 
define and use your own macros. The second section defines the syntax and 
describes the operation of the macro processor's built-in functions. The final section 
of the chapter is devoted to advanced concepts in MPL. 

The first two sections give enough information to begin using the macro processor. 
However, sometimes a more exact understanding of MPL's operation is needed. 
The advanced concepts section should fill those needs. 



Macro Processor Overview 

The macro processor views the source file in very different terms than does the 
assembler. To the assembler, the source file is a series of control lines, instruction 
lines, and directive lines. To the macro processor, the source file is a long string of 
characters. Figure 7-1 illustrates these two different views of the input file. 



MOV AX, 27 
ADD AX, 55 
MOV BX.AX 




Figure 7-1 . Macro Processor versus Assembler — 
Two Different Views of a Source File 
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The Macro Processing Language ASM86 



All macro processing of the source file is performed before your code is assembled. 
Because of this independence between the processing of macros and assembly of 
code, we must differentiate between macro-time and assembly-time. At macro-time, 
assembly language symbols— labels, predefined assembler symbols, EQU symbols, 
and the location counter are not known. The macro processor does not recognize the 
assembly language. Similarly, at assembly-time no information about macros is 
known. 

The macro processor scans the source file looking for macro calls. A macro call is 
actually a request to the macro processor either to (re)define a user-defined macro or 
to replace a built-in or user-defined macro with its defined value. 

This defined value or return value of a macro is the text that replaces the macro call. 
The return value of some macros is the null string. (The null string is a character 
string containing no characters.) In other words, when these macros are called, the 
calls are removed from the input stream. In their place, the assembler sees the return 
value kept. 

Thus, when a macro call is encountered, the macro processor expands the call to its 
return value. The return value of a macro is then passed to the assembler and the 
macro processor continues. All characters that are not part of a macro call are 
passed to the assembler. 



Creating and Calling Macros 

The macro processor is a character string replacement facility. It searches the source 
file for a macro call, and then replaces the call with the macro's return value. The 
metacharacter {% is the default) signals a macro call. Until the macro processor 
finds a metacharacter, it does not process text. It simply passes the text from the 
source file to the rest of the assembler. 

Since MPL only processes macro calls, it is necessary to call a macro in order to 
create other macros. The built-in function DEFINE creates macros. Built-in func- 
tions are a predefined part of the macro language, so they may be called without 
prior definition. The general syntax for DEFINE is: 

% [*] DEFlNE{call~pattern )[Iocal-symbol-list }{macro-body) 

DEFINE is the most important MPL built-in function. This section of the chapter is 
devoted to describing this built-in function. Each of the symbols in the syntax above 
{call-pattern, local-symbol-list, and macro-body) are thoroughly described in the 
pages that follow. In some cases we have abbreviated this general syntax to 
emphasize certain concepts. 

Creating Parameterless Macros 

When you create a parameterless macro, there are two parts to a DEFINE call: the 
call pattern and the macro body. The call pattern defines the name used when the 
macro is called; the macro body defines the return value of the call. 

The syntax of a parameterless macro definition is shown below: 

%* DEFINE {call-pattern) {macro-body) 

The '%' is the metacharacter that signals a macro call. The '*' is the literal character 
that is normally used when defining macros. The exact use of the literal character is 
discussed in the advanced concepts section. 
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ASM86 The Macro Processing Language 



When you define a parameterless macro, the call-pattern is a macro identifier that 
will follow the metacharacter in the source file. The rules for macro identifiers are: 

• The identifier must begin with an alphabetic character (A,B,C,...,Z or 
a,b,c,...z). 

• The remaining characters may be alphabetic, special (a question mark (?) or an 
underscore character ( )), or decimal digits (0,1, 2,..., 9). 

• Only the first 31 characters of a macro identifier are significant. Upper and 
lower case characters are not distinguished in a macro identifier. 



The macro-body is usually the return value of the macro call. However, the macro- 
body may contain calls to other macros. If so, the return value is actually the fully 
expanded macro body, including the return values of the calls to other macros. 
When you define a macro using the literal character, '*', shown above, macro calls 
contained in the body of the macro are not expanded until you call the macro. The 
macro call is reexpanded each time it is called. 



Example 1 . Nested Macro 

%*DEFINE(ASTRING) (PHANT) 
%*DEFINE(JUMBO) <ELtE%ASTRING) 

Call— %JUMB0 

is expanded to— ELEPHANT 

The syntax of DEFINE requires that left and right parentheses surround the macro- 
body. For this reason, you must have balanced parentheses within the macro body, 
(i.e., each left parenthesis must have a succeeding right parenthesis, and each right 
parenthesis must have a preceding left parenthesis.) We call character strings that 
meet these requirements balanced-text . 



Example 2. Balanced and Unbalanced '( )' 

Balanced strings — 

(abc) 

(a(b)c) 

((ab(c)d)e) 

Unbalanced strings — 

(abc 

(a(b)c 

(ab(c) 

To call a macro, you use the metacharacter followed by the call-pattern for the 
macro. (The literal character is generally not needed when you call a user-defined 
macro.) The macro processor will remove the call and insert the return value of the 
call. If the macro body contains any call to other macros, they will be replaced with 
their return values. 
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Example 3. Macro Calls 

%*DEF INE (ME) ( I LIKE) 

%* DEFINE (WHAT (OBJECT)) (MY % B J E C T ) 

Calls— 

%ME -* I LIKE 

%WHAT (BIKE) -> MY BIKE 

%ME % W H A T ( J B ) . -» I LIKE MY JOB. 

Once a macro has been created, it may be redefined by a second call to DEFINE. 

Example 4. Redefinition of Macros 

%*DE FINE (LINCOLN) (GETTYSBURG) 

% L I N C L N WILL EXPAND TO -> GETTYSBURG 

%*DEFINE(LINCOLN> (ONE CENT) 

%LINC0LN WILL EXPAND TO -» ONE CENT 

The three examples below show several macro definitions. Their return values are 
also shown. 

NOTE 

In order to postpone discussion of the use of local macro symbols for labels, 
location counter relative addressing (with '$') is used in these examples. 
This is done for simplicity, but is not generally recommended because dif- 
ferent addressing modes produce different instruction sizes which will affect 
the location counter offset required. 

Example 1 : 

Macro definition at the top of the program: 

%*DEFINE (MOVE) ( 
MOV CXJOO 
LEA S I , TAB LE1 
LEA DI , TAB LE2 

REP MOVSW 
) 

Macro call as it appears in program: 

PUSH CX 
%M0VE 
POP CX 

The program after the macro processor makes the expansion: 

PUSH CX 
MOV CX , 1 00 
LEA SI , TABLE1 
LEA SI , TABLE2 

REP MOVSW 
POP CX 
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Example 2: 

Macro definition at the top of the program: 

%*DEFINE (ADD5M 

MOV CXJOO 

MOV SI,0 

MOV AX,TABLE2[SI] 

ADD AX, 5 

MOV TABLE2CSI], AX 

INC SI 

INC SI 

LOOPZ $-13 

) 

The macro call as it appears in the original program body: 

PUSH AX 
% A D D 5 

POP AX 

The program after macro expansion: 

PUSH AX 

MOV CX,100 

MOV SI,0 

MOV AX f TABLE2CSI] 

ADD AX,5 

MOV TABLE2 [SI ] , AX 

INC SI 

INC SI 

LOOPZ $-13 

POP AX 

Example 3: 

Macro definition at the top of the program: 

%*DEFINE(MOV_AND_ADD) ( 

%M0VE 

% A D D 5 

) 

The macro call as it appears in the body of the program: 

%M0VE_AND_ADD 

The program after macro expansion: 

MOV CXJOO 
LEA S I , TABLE1 
LEA SI f TABLE2 

REP MOVSW 

MOV CXJOO 

MOV S 1 , 

MOV AX,TABLE2[SI3 

ADD AX, 5 

MOV TABLE2 [SI ] ,AX 

INC SI 

INC SI 

LOOPZ $-13 
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Creating Macros with Parameters 

If the only thing the macro processor could do was simple string replacement, then it 
would not be very useful for most programming tasks. Each time we wanted to 
change even the simplest part of the macro's return value we would have to redefine 
the macro. Parameters in macro calls allow more general-purpose macros. 

Parameters leave holes in a macro body that are filled in when you call the macro. 
This permits you to design a single macro that produces code for many typical pro- 
gramming operations. 

The term parameter refers to both the formal parameters that are specified when the 
macro is defined (the holes), and the actual parameters or arguments that are 
specified when the macro is called (the fill-ins). 

The syntax for defining macros with parameters is very similar to the syntax for 
macros without parameters. The call-pattern that we described earlier actually 
includes both the macro-name and an optional parameter-list. With this addition 
the syntax for the DEFINE built-in function becomes: 

%*DEFlNE{macro-name[(parameter-list)]) (macro-body) 

NOTE 

This is not the only format allowable but a specific case. The parentheses 
are not the only delimiters that can be used (see the Advanced MPL Con- 
cepts section). 

The macro-name must be a valid macro identifier. 

The parameter-list is a list of macro identifiers separated by macro delimiters, 
usually commas. These identifiers comprise the formal parameters used in the 
macro. The macro identifier for each parameter in the list must be unique. 

The macro-body must be a balanced-text string. The locations of parameter replace- 
ment (the placeholders to be filled in by the actual parameters) are indicated by plac- 
ing a parameter's name preceded by the metacharacter in the macro body. The 
parameters may be used any number of times and in any order within the macro 
body. (If a user-defined macro has the same macro identifier name as one of the 
parameters to the macro, the macro may not be called within the macro body since 
the name would be recognized as a parameter.) 

The example below shows the definition of a macro with three parameters — 
SOURCE, DEST, and COUNT. The macro will produce code to copy any number 
of words from one part of memory to another. 

%*DE FINE (MOVE_ADD_GEN (SOURCE, DEST, COUNT) ) ( 

MOV CX,%C0UNT 

MOV SI,0 

MOV AX , %S0URCE[SI] 

MOV % D E S T C S I ] ,AX 

INC SI 

INC SI 

LOOPZ $-13 
) 

To call a macro with parameters you must use the metacharacter followed by the 
macro's name as with parameterless macros. However, a list of the actual 
parameters must follow. In the most simple case these actual parameters are 
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enclosed with parentheses, and separted from each other by commas. The actual 
parameters must be balanced-text and may optionally contain calls to other macros. 
A simple call to the macro defined above might be: 

%MOVE_ADD_GEN (INPUT, STORE, 100H) 

The above macro call produces the following code: 

MOV CXJOOH 

MOV SI,0 

MOV AX, INPUTCSI] 

MOV STORE[SI],AX 

INC SI 

INC SI 

LOOPZ $-13 

LOCAL Symbols in Macros 

The LOOPZ instruction uses offset addressing ($-13). However, if the instructions 

in the macro MOVE ADD GEN are modified, the offset address ($-13) may need 

to be changed. This is a disadvantage of using offset addressing. If we chose to use a 
label for the jump destination, macro modification would generally not affect the 
label. However, the macro could only be used once, since a second call to the macro 
would cause a conflict in label definitions at assembly time. We could make the label 
a parameter and specify a different symbol name each time we call the macro. A 
preferable way to ensure a unique label for each macro call is to put the label in a 
LOCAL list. The LOCAL list construct allows you to use macro identifiers to 
specify assembly-time symbols. Each use of a LOCAL symbol in a macro guarantees 
that the symbol will be replaced by a unique assembly-time symbol each time the 
macro is called. 

The macro processor increments a counter once for each symbol used in the list 
every time your program calls a macro that uses the LOCAL construct. Symbols in 
the LOCAL list, when used in the macro body, receive a two to five digit suffix that 
is the hexadecimal value of the counter. The first time you call a macro that uses the 
LOCAL construct the suffix is '00'. 

The syntax for the LOCAL construct in the DEFINE function is shown below. (This 
is the complete syntax for the built-in function DEFINE): 

°Jo*DEFlNE(macro-name\parameter-list]) [LOCAL local-list] {macro-body) 

The local-list is a list of valid macro identifiers separated by spaces. Since these 
macro identifiers are not parameters, the LOCAL construct in a macro has no affect 
on the syntax of a macro call. 

The example below shows the MOVE ADD GEN macro definition that uses a 

LOCAL list: 

%*DEFINE(MOVE_ADD_GEN(SOURCE,DEST, COUNT)) LOCAL LABEL ( 

MOV CX,%C0UNT 

MOV SI,0 
'/.LABEL: MOV AX , % S U R C E [ S I] 

MOV % D E S T [ S I ] ,AX 

INC SI 

INC SI 

LOOPZ %LABEL 
) 
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The following macro call: 

%MOVE_ADD_GEN (DATA, FILE # 67) 

would produce this code if this is the eleventh call to a macro using a LOCAL list: 

MOV CX , 67 

MOV SI,0 

LABELOA: MOV AX,DATA[SI] 

MOV FILECSI] ,AX 

INC SI 

INC SI 

LOOPZ LABELOA 

Since macro identifiers follow the same rules as ASM86, you can use any macro 
identifier in a LOCAL list. However, if you use long identifier names, they should 
be restricted to 26 characters. Otherwise the label suffix may cause the identifiers to 
exceed 31 characters and the excess characters would be truncated. 



The Macro Processor's Built-in Functions 

The macro processor has several built-in or predefined macro functions. These built- 
in functions perform many useful operations that would be difficult or impossible to 
produce in a user-defined macro. An important difference between a user-defined 
macro and a built-in function is that user-defined macros may be redefined, while 
built-in functions cannot be redefined. 

We have already seen one of these built-in functions, DEFINE. DEFINE creates 
user-defined macros. DEFINE does this by adding an entry in the macro processor's 
table of macro definitions. Each entry in the table includes the call-pattern for a 
macro, and its macro body. Entries for the built-in functions are present when the 
macro processor begins operation. 

Other built-in functions perform numerical and logical expression evaluation, affect 
control flow of the macro processor, manipulate character strings, and perform 
console I/O (see Appendix D for a listing of the MPL built-in functions). 



Comment, Escape, Bracket and METACHAR 
Built-in Functions 

Comment Function 

The Macro Processing Language can be very subtle, and the operation of macros 
written in a straightforward manner may not be immediately obvious. Therefore, it 
is often necessary to comment your macro definitions. 

The macro processor's comment function has the following syntax: 

%'fexf' 
or 

tfo'text end-of-line 
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The comment function always evaluates to the null string. Two terminating 
characters are recognized, the apostrophe and the end-of-line (line feed character, 
ASCII OAH). The second form of the call allows you to spread macro definitions 
over several lines, while avoiding any unwanted end-of-lines in the return value. In 
either form of the comment function, the text or comment is not evaluated for 
macro calls. 

The example below shows a commented macro definition: 

%*DEF INE CMOVE_.ADD_GEN <SOURCE,DEST, COUNT)) LOCAL LABEL ( 

MOV CX , %C0UNT % ' COUNT SHOULD BE A CONSTANT 
MOV S I , 
%LABEL %' %LABEL IS A LOCAL SYMBOL IT WILL HAVE A NUMBER ADDED 
: MOV AX , %S0URCE [SI] %' SOURCE MUST BE A WORD ADDRESS' 

MOV %DEST [SI] , AX % ' DEST MUST ALSO BE A WORD ADDRESS' 
INC SI 
INC SI 

LOOPZ %LABEL X 'THIS WILL HAVE THE SAME NUMBER ADDED 
%• AS THE % L A B E L ABOVE' 
) 



Call to above macro: 

%MOVE_ADD_GEN(DATA, STOR, 20H) 

Return-value from above call: 

MOV CX,20H MOV S 1 , 
LABEL07: MOV AX , DATA ESI] 
MOV ST0RCSI3 , AX 

INC SI 
INC SI 
LOOPZ LABEL07 

Notice that the comments that were terminated with end-of-line removed the end-of- 
line character along with the rest of the comment. 

Note that the metacharacter is not recognized as flagging a call to the macro pro- 
cessor when it appears in the comment function. 



Escape Function 

Occasionally, it is necessary to prevent the macro processor from processing text. 
There are two built-in functions that perform this operation: the escape function 
and the bracket function. 

The escape function interrupts the processor from its normal scanning of text. The 
syntax for this function is shown below: 

%n text-n-characters-long 

The metacharacter followed by a single decimal digit designates that the specified 
number of characters (maximum is 9) shall not be evaluated. The escape function is 
useful for inserting a metacharacter as text, adding a comma as part of an argument, 
or placing a single parenthesis in a character string that requires balanced 
parentheses. 
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Several examples of the escape function are shown below: 
MACCALL is defined as follows: 

%*DEFINE(MACCALL(ARG1 , ARG2, ARG3) ) 
( 

; %AR61 

; % A R G 2 

; % A R G 3 
) 



Before Macro Expansion 

; COMPUTE 1 0%1 % OF SUM -» 

%MACCALL(JANUARY 23%1 , 1980, -* 

MARCH 15%1 , 1980, -» 

APRIL 9%1 , 1980) -» 

%MACCALL(1%1) ADD INPUTS, -> 

2X1) DIVIDE BY INPUT -» 

3%1) GET INPUTS) -> 



After Macro Expansion 
(actual parameters) 

COMPUTE 10% OF SUM 

JANUARY 23, 1980 
MARCH 15, 1980 
APRIL 9, 1980 

1) ADD INPUTS 

2) DIVIDE BY INPUT 

3) GET INPUTS 



Bracket Function 

The other built-in function that inhibits the macro processor from expanding text is 
the bracket function. The syntax of the bracket function is shown below: 

^{balanced-text) 

The bracket function inhibits all macro processor expansion of the text contained 
within the parentheses except for the escape function, the comment function, and 
parameters which are still recognized. Since there is no restriction on the length of 
the text within the bracket function, it is often easier to use than the escape function. 
However, since balanced text is required and the metacharacter is interpreted, 
sometimes the bracket function does not do what you want and the escape function 
must be used. 

Consider the following macro: 

%*DEFINE(DW(LIST,NAME)) ( 

% N A M E DW %LI ST 

) 



The macro above will add DW statements to the source file. It uses two parameters: 
one for the variable name and one for the DW expression list. Without the bracket 
or several escape functons we would not be able to use more than one expression in 
the list, since the first comma would be interpreted as the delimiter separating the 
macro parameters. The bracket function permits more than one expression in the 
LIST argument: 

% D W ( % ( 1 9 8 H , 3DBH, 1 63BH) , PH0NE)-> PHONE DW 198H, 3DBH, 163H 

In the example above the bracket function prevents the character string '198H, 
3DBH, 163BH' from being evaluated as separate parameters. 
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METACHAR Function 

The built-in function METACHAR allows you to redefine the metacharacter ini- 
tially (%). Its syntax is shown below: 

%MET ACH AR{balanced-text) 

The following example changes the metacharacter from (%) to (&): 

%METACHAR(&) 

The balanced-text argument may be any number of characters long. However, only 
the first character in the string, i.e., the character immediately after the '(', is taken 
to be the new metcharacter. Extreme caution should be taken when using 
METACHAR, since it can have catastrophic effects. Consider the example below: 

%METACHAR( & ) 

In this example METACHAR defines the space character to be the new 
metacharacter, since it is the first character in the balanced-text string! 

Numbers and Expressions in MPL 

Many of the built-in functions recognize and evaluate numerical expressions in their 
arguments. MPL uses the same rules for representing numbers as ASM86 (see 
Chapter 3): 

• Numbers may be represented in base 2 (B suffix), base 8 (O or Q suffix), base 10 
(D suffix or no suffix), and base 16 (H suffix). 

• Internal representation of numbers is 17 bits (-0FFFFH to +0FFFFH). The 
processor does not recognize real or long integer numbers. 

• The operators recognized by the macro processor and their order of precedence 
is shown in the list below (see Chapter 4 for discussion of these operators): 

1. ( ) (highest precedence) 

2. HIGH, LOW, 

3. *,/,MOD,SHL, SHR 

4. +, -(both unary and binary forms) 

5. EQ,NE, LE, LT, GE, GT 

6. NOT 

7. AND 

8. OR, XOR (lowest precedence) 

The macro processor cannot access the assembler's symbol table. The values of 
labels, location counter, and EQU symbols are not known during macro-time 
expression evaluation. Any attempt to use assembly-time symbols in a macro-time 
expression generates an error. However, you can define macro-time symbols with 
the predefined macro SET. 



SET Macro 

SET assigns the value of the numeric expression to the identifier, macro-id, and 
stores the macro-id in the macro-time symbol table, macro-id must follow the same 
syntax conventions used for other macro identifiers. SET has the following syntax: 

°/oSE7(macro-id, expression) 
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The SET macro call affects the macro-time symbol table only; when SET is 
encountered in the source file, the macro processor replaces it with the null string. 
Symbols defined by SET can be redefined by a second SET call, or defined as a 
macro by a DEFINE call. In fact, if you ever assemble your source with the GEN 
control in effect you will see that SET uses the DEFINE built-in function to create 
the numeric symbols. 



The following examples show several ways to use SET: 



Before Macro Expansion 

%SET(COUNT,0) 

%SET(0FFSET,16) 

MOV AX, %C0UNT + %0F FSET 

MOV BX, % C U N T 



After Macro Expansion 



null string 
null string 
MOV AX, 00H 
MOV BX, 00H 



+ 10H 



SET can also be used to redefine symbols in the macro-time table: 

%SET(C0UNT,%C0UNT + % F F S E T ) -> null string 

%SET(OFFSET,%OFFSET * 2) -» null string 

MOV AX, %C0UNT + %0F FSET -* MOV AX, 1 0H 

MOV BX, % C U N T -» MOV BX, 1 OH 



+ 20H 



SET is a predefined macro, not a built-in function; as such it may be redefined, 
however, you will then loose this function. 



EVAL Function 

The built-in function EVAL accepts an expression as its argument and returns the 
expression's value in hexadecimal. The syntax for EVAL is: 

%EV AL(expression ) 

The expression argument must be a legal macro-time expression. 

The return-value from EVAL follows ASM86's rules for representing hexadecimal 
numbers (see Chapter 3). EVAL always returns an expression with at least 3 
characters even if the argument evaluates to a single digit. The leading character is 
always a decimal-digit (0,1, 2,..., 9). The remaining digits may be any hexadecimal 
digit (0,1,2,...E,F). The trailing character must always be the hexadecimal suffix 
(H). The following examples show the return-value from EVAL: 



Before Macro Expansion 

MOV AX, %EVAL(1+1); move two to AX 

COUNT EQU %EVAL(33H + 15H + 0F00H) 

ADD AX, %EVAL(10H-((13 + 6) * 2) + 

%SET(NUM1 ,44) 

%SET(NUM2,25H) 

MOV AX, %EVAL(°/.NUM1 LE %NUM2) 



7) 



After Macro Expansion 

-» MOV AX, 02H; move 

two to AX 
-> COUNT EQU 0F48H 
-» ADD AX, 0FFF1H 
-> null string 
-» null string 
-» MOV AX, 00H 



Logical Expressions and String Comparisons in MPL 

Several built-in functions return a logical value when they are called. Like relational 
operators that compare numbers and return true or false (-1H or 00H), respectively, 
these built-in functions compare character strings. If the function evaluates to 
'TRUE,' then it returns the character string '-1FT (all ones). If the function 
evaluates to 'FALSE,' then it returns '00H' (zeros). 
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The built-in functions that return a logical value compare two balanced-text string 
arguments and return a logical value based on that comparison. The list of string 
comparison functions below shows the syntax and describes the type of comparison 
made for each. Both arguments to these functions may contain macro calls (the calls 
are expanded before the comparison is made). 



%EQS{arg1 ,arg2) 
%NES(argf7 ,arg2) 
%LTS{arg1 ,arg2) 

%LES{arg1 ,arg2) 

%GJS(arg1 ,arg2) 
%GES(arg1 ,arg2) 



True if both arguments are identical; equal 

True if arguments are different in any way; not equal 

True if first argument has a lower value than second 
argument; less than 

True if first argument has a lower value than second 
argument or if both arguments are identical; less 
than or equal 

True if first argument has a higher value than second 
argument; greater than 

True if first argument has a higher value than second 
argument, or if both arguments are identical; greater 
than or equal 



Before these functions perform a comparison, both arguments are completely 
expanded. Then the ASCII value of the first character in the first string is compared 
to the ASCII value of the first character in the second string. If they differ, then the 
string with the higher ASCII value is considered to be greater. If the first characters 
are the same, then the process continues with the second character in each string, 
and so on. Only two strings of equal length that contain the same characters in the 
same order are equal. 



Before Macro Expansion 

%GTS(16D,11H) 

%EQS(ABC,ABC) 
%EQS(ABC, ABC) 
%LTS(CBA,cba) 

%GES(ABCDEF,ABCDEF ) 



After Macro Expansion 

-1H these macros compare strings 
true not numerical values; ASCII '6' 
is greater than ASCII '1' 

-1H the character strings are 
true identical 

00H the space after the comma is 
false part of the second argument 

-1H the lower-case characters have 
true a higher ASCII value than 
upper-case 

00H the space at the end of the 
false second argument makes the 

second argument greater than 

the first 



As with any other macro, the arguments to the string comparison macros can be 
other macros. 



%*DEFINE(DOG) (CAT) 
%*DEFINE(MOUSE) (%D0G) 
% E Q S ( % D G , % M U S E ) 



-1H 
true 
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Control Flow and Conditional Assemblies 

Some built-in functions expect logical expressions in their arguments. Logical 
expressions follow the same rules as numeric expressions. The difference is in how 
the macro interprets the 17-bit value that the expression represents. Once the expres- 
sion has been evaluated to a 17-bit value, MPL uses only the low-order bit to deter- 
mine whether the expression is TRUE or FALSE. If the low-order bit is a one (the 
17-bit numeric value is odd), the expression is TRUE. If the low-order bit is a zero 
(the 17-bit value is even), the expression is FALSE. 

Typically, you will use either the relational operators (EQ, NE, LE, LT, GT, or GE) 
or the string comparison functions (EQS, NES, LES, LTS, GTS, or GES) to specify 
a logical value. Since these operators and functions always evaluate to -1H (all 
ones) or 00H (all zeros), you needn't worry about the single bit test. But remember, 
all numeric expressions are valid, and regardless of the value of the other 16 bits, 
only the least significant bit counts. 



IF Function 

The IF built-in function evaluates a logical expression, and based on that expression, 
expands or withholds it text arguments. The syntax for the IF macro is shown below: 

%IF (expression) THEN (balanced-textl) [ELSE (balanced-text2)] FI 

The IF function first evaluates the expression. If the low order bit is one, then 
balanced-textl is expanded; if the low order bit is zero and the optional ELSE clause 
is included in the call, then balanced-textl is expanded. If the low order bit is zero 
and the ELSE clause is not included, the IF call returns the null string. FI must be 
included to terminate the call. 

IF calls can be nested; when they are, the ELSE clause refers to the most recent IF 
call that is still open (not terminated by FI). FI terminates the most recent IF call 
that is still open. 

Several examples of IF calls are shown below: 

This is a simple example of the IF call with no ELSE clause. 

XIF (%GTS(OFFH,XVAR)) THEN (MOV AX, %VAR) F1 

This is the simple form of the IF call with an ELSE clause. 

XIF (%EQS (ADD AX, %0PERATI0N)) THEN (ADD BX, %R1) ELSE (ADD BX, %R2) Fl 

This is an example of several nested IF calls. 

openfirstIF %IF (%EQS (%0PER , ADD) ) THEN ( ADD AX, DATUM 

) ELSE ( 
open second IF XIF (%EQS (%0PER , SUB) ) THEN ( SUB AX, DATUM 

) ELSE ( 
open third IF XIF (%EQS ( % P E R , MULT) ) THEN ( MUL DATUM 

) ELSE (DIV DATUM 
close third IF ) F I 

close second IF ) F I 

close first IF ) F I 
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Example 5. Conditional Assembly 



%SET (DEBUG, 1) 
XIF (DEBUG) THEN ( 
AX, DEBUG_FLAG 
2 



MOV 

OUT 

) 

MOV 

SUB 



AX, 

BX, 
BX, 



OFFSET 
1 



ARRAY 



will expand to: 

MOV AX, DEBUG_FLAG 

OUT AX, 2 

MOV BX, OFFSET ARRAY 

SUB BX, 1 

You could change the %SET to 

%SET (DEBUG, 0) 

to turn off the 'debug' code. 



WHILE Function 

The IF macro is useful for implementing one kind of conditional assembly — 
including or excluding lines of code in the source file. However, in many cases this is 
not enough. Often you may wish to perform macro operations until a certain condi- 
tion is met. The built-in function WHILE provides this facility. 

The syntax of the WHILE macro is shown below: 
%WHILE (expression) (balanced -text) 

The WHILE function evaluates the expresson . If the least significant bit is one, then 
the balanced-text is expanded; otherwise, it is not. Once the balanced-text has been 
expanded, the logical argument is retested and if the least significant bit is still one, 
then the balanced-text is again expanded. This continues until the logical argument 
proves false (the least significant bit is 0). 

Since the macro continues processing until expression is false, the balanced-text 
should modify expression , or else WHILE may never terminate. 

A call to the built-in function EXIT will always terminate a WHILE macro. EXIT is 
described below. 

The following examples show two common uses of the WHILE macro: 

%SET(C0UNTER,5) 
%WHILE(°/.C0UNTER GT 0) 
(INC BX 
%SET(C0UNTER, %C0UNTER - 1) 

) 

% W H I L E ( % C U N T LT OFFH) ( HLT 

%SET(C0UNT, %C0UNT+1) ) 

These examples use the SET macro and a macro-time symbol to count the iterations 
of the WHILE macro. 
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REPEAT Function 

MPL offers another built-in function that will perform the counting loop 
automatically. The built-in function REPEAT expands its balanced-text a specified 
number of times. The general form of the call to REPEAT is shown below: 

% REPEAT (expression) (balanced-text) 

Unlike the IF and WHILE macros, REPEAT uses the expression for a numerical 
value that specifies the number of times the balanced-text will be expanded. The 
expression is evaluated once when the macro is first called, then the specified 
number of iterations is performed. 

The examples below will perform the same text insertion as the WHILE examples 
above. 

%REPEAT (5) (INC BX 
) 

% R E P E A T (OFFH - COUNT) (HLT 
) 

Note that the line feeds preceding the right paren in each of the above examples are 
necessary for correct assembly. 



EXIT Function 

The EXIT built-in function terminates expansion of the most recently called 
REPEAT, WHILE or user-defined macro. It is most commonly used to avoid 
infinite loops (e.g., a WHILE expression that never becomes false, or a recursive 
user-defined macro that never terminates). It allows several exit points in the same 
macro. 

The syntax for EXIT is: 

°7oEXiT 

Two examples of how you might use the EXIT macro follow: 

This use of EXIT terminates a recursive macro when an odd number of bytes have 
been added. 

%*DEFINE(MEM_ADD_MEM(SOURCE, DESTIN, BYTES)) ( 
MOV AL,%S0URCE 
ADD AL,%DESTIN 
MOV %DESTIN,AL 

IF (%BYTES EQ 1) THEN (%EX IT) F I 
MOV AL, % S U R C E + 1 
ADD AL, % DESTIN + 1 
MOV %DESTIN + 1 , AL 
IF ( % B Y T E S GT 2 ) THEN 
(%MEM_ADD_MEM(%S0URCE + 2 f %D-ESTIN + 2 f %BYTES-2) ) FI 
) 

The above example adds two pairs of bytes and stores the results in DESTIN. As 
long as there are more than two pairs of bytes to be added, the macro 
MEM^ADD„„MEM is expanded. That is, as long as BYTES is greater than 2, the 
expansion continues. When BYTES reaches a value of 1 (odd number of byte pairs) 
the macro is exited. 
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This EXIT is a simple jump out of a recursive loop. 

%*DEFINE(UNTIL (CONDITION, BODY)) 
( % B D Y 

XIF (%C0NDITI0N) THEN (%EX IT) 

ELSE (%UNTIL(%C0NDITI0N,%B0DY)) FI 

This example assumes that BODY is a macro that modifies CONDITION such that 
CONDITION eventually becomes true. 



String Manipulation Built-in Functions 

The purpose of the Macro Processor is to manipulate character strings. Therefore, 
there are several built-in functions that perform common character string manipula- 
tion functions. 



LEN Function 

The built-in function LEN takes a character string argument and returns the length 
of the character string in hexadecimal (the same format as EVAL). The character 
string argument to LEN is limited to 256 characters. 

The syntax of the LEN macro call is shown below: 

% LEN(balanced-text) 

Several examples of calls to LEN and the hexadecimal numbers returned are shown 
below: 



Before Macro Expansion After Macro Expansion 

%LEN(ABCDEFGHIJKLMNOPQRSTUVWXYZ) -> 1AH 

%LEN(A,B,C) -» 5 H commas are counted 

%LEN() -» 00H 

%*DEFINE(CHEESE) (MOUSE) 

%*DEFINE(DOG) (CAT) 

%LEN(°/.D0G % C H E E S E ) -> 09H 

A the space after G is 
counted as part of the 
Length 



SUBSTR Function 

The built-in function SUBSTR returns a substring of its text argument. The macro 
takes three arguments: a balanced character string to be divided and two numeric 
arguments. The syntax of the macro call to SUBSTR is shown below: 

%S\JB$TR(balanced-text expression 1 ,expression2) 

balanced-text is described above. 

expression 1 specifies the starting character of the substring. 

expression2 specifies the number of characters to be included in the substring. 
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If expression! is zero or greater than the length of the argument string, then 
SUBSTR returns the null string. 

If expression2 is zero, then SUBSTR returns the null string. If expression! is greater 
than the remaining length of the string, then all characters from the start character 
of the substring to the end of the string are included. 

The examples below show several calls to SUBSTR and the value returned: 

Before Macro Expansion After Macro Expansion 

%SUBSTR (ABCDEFG f 5 f 1 ) -> E 

%SUBSTR(ABCDEFG,5,100) -» EF6 

%SUBSTR(123(56)890,4,4) -* (56) 

%SUBSTR (ABCDE FG , 8, 1 ) -» null 

%SUBSTR(ABCDEFG,3,0) -» null 

MATCH Function 

The built-in function MATCH searches a character string for a delimiter character 
and assigns the substrings on either side of the delimiter to the identifiers. The 
syntax of the MATCH call is shown below: 

°kMA7CH(identi fieri delimiter identifier!) {balanced-text) 

identifierl and identifier! are valid MPL identifiers. 

delimiter is the first character to follow identifierl. Typically, a space or comma is 
used, but any character that is not a macro identifier character may be used. You 
can find a more complete description of delimiters in the Advanced Concepts section 
at the end of the chapter. 

balanced-text is as described earlier in the chapter. 

MATCH searches the balanced-text string for the specified delimiter. When the 
delimiter character is found, then all characters to the left of it are assigned to iden- 
tifierl and all characters to the right are assigned to identifier!. If the delimiter is 
not found, the entire balanced-text string is assigned to identifierl and the null 
string is assigned to identifier!. 

The following example shows a typical use of the MATCH macro. 

% M A T C H (NEXT, LIST) (10H, 20H, 30H) 

MOV SI, VAR_PTR 
%WH I LE ( % L E N ( % N E X T ) NE 0) ( 

MOV BX, % N E X T 

MOV AX, [BX+SI] 

ADD AX,22H 

MOV [BX+SI], AX 

% MATCH (NEXT,LIST)CXLIST) 

) 

Produces the following code: 

MOV BX, 10H 

first iteration MOV AX, [BX + SI] 

ofWHILE ADD AX,22H 

MOV [BX+SI], AX 
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MOV BX, 20H 

second iteration MOV AX, [BX + SI] 

ofWHUE ADD AX,22H 

MOV [BX+SI], AX 

MOV BX, 30H 

third iteration MOV AX, [BX + SI] 

ofWHILE ADD AX,22H 

MOV [BX+SI], AX 



Console I/O Built-in Functions 

Four built-in functions perform console I/O. The first two, IN and OUT, are line 
oriented. IN outputs the characters '>>' as a prompt to the console, and returns the 
next line typed at the console including the line terminator. OUT outputs a string to 
the console; the return value of OUT is the null string. The syntax of both macros is 
shown below: 

%IN 
VoO\JT(balanced-text) 

Several examples of how these macros can be used are shown below: 

%0UT(ENTER NUMBER OF PROCESSORS IN SYSTEM) 
%SET(PROC_CO!JNT,%IN) 

%0UT(ENTER THIS PROCESSOR'S ADDRESS) 
ADDRESS EQU 7.IN 

%0UT(ENTER BAUD RATE) 
%SET(BAUD,%IN) 

The following lines would be displayed at the console: 

ENTER NUMBER OF PROCESSORS IN SYSTEM >user response 
ENTER THIS PROCESSOR'S ADDRESS >user response 
ENTER BAUD RATE >user response 

The second two, CI and CO, are character oriented functions. CI returns a single 
character typed at the console. CI neither prompts for input nor echoes the character 
typed. CO outputs a single character to the console; the return value of CO is the 
null string. The syntax of the CI and CO macros is: 

%C I 

% C ( char) 

The following example defines the macro NUMBER to be a string of three 
characters typed at the console, and echoes the characters as they are typed: 

XDEF I NE(NUMBER) ( ) 

XREPEAT(3)C X D E F I N E ( A ) ( % C I ) %C0(XA) 

XDEFINE(NUMBER)CXNUMBERXA) ) 



Advanced MPL Concepts 

For most programming problems, the Macro Processing Language as described 
above is sufficient. However, in some cases a more complete description of the 
macro processor's function is necessary. 
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However, it is impossible to describe all of the subtleties of the macro processor in a 
single chapter. With the rules described in this section, you should be able to discern, 
with a few simple tests, the answer to any specific question about MPL. 

Macro Delimiters 

When we discussed the syntax for defining macros, the parameter-list was sur- 
rounded by parentheses, and parameters were separated by commas. Because we 
used these delimiters to define a macro, a call to the macro required that these same 
delimiters be used. When we discussed the MATCH function, we mentioned that a 
space could be used as a delimiter. In fact the macro processor permits almost any 
character or group of characters to be used as a delimiter. 

Regardless of the type of delimiter used to define a macro, once it has been defined, 
only the delimiters used in the definition can be used in the macro call. Macros 
defined with parentheses and commas require parentheses and commas in the macro 
call. Macros defined with spaces (or any other delimiter) require that specific 
delimiter when called. 

Macro delimiters can be divided into three classes: implied blank delimiters, iden- 
tifier (or id) delimiters and literal delimiters. 

Implied Blank Delimiters 

Implied blank delimiters are easy to use and contribute readability and flexibility to 
macro calls and definitions. An implied blank delimiter is one or more spaces, tabs 
or new lines (a carriage-return/linefeed pair or just a linefeed) in any order. To 
define a macro that uses the implied blank delimiter, simply place one or more 
spaces, tabs or new lines surrounding the parameter list and separating the formal 
parameters. 

When you call the macro defined with the implied blank delimiter, each delimiter 
will match a series of spaces, tabs, or new lines. Each parameter in the call begins 
with the first non-blank character, and ends with the next blank character. 

An example of a macro defined using implied blank delimiters is: 

%*DEF INE (SENTENCE SUBJECT VERB OBJECT) (THE "/.SUBJECT %VERB %0B J ECT . 

All of the following calls are valid for the above definition: 

Before Macro Expansion After Macro Expansion 

"/.SENTENCE TIME IS RIPE -> THE TIME IS RIPE. 

^.SENTENCE CATS 

EAT 

FISH -> THE CATS EAT FISH. 

% S E N T E N C E 

PEOPLE 
LIKE FREEDOM -> THE PEOPLE LIKE FREEDOM. 

Identifier Delimiters 

Identifier (id) delimiters are legal macro identifiers designated as delimiters. To 
define a macro that uses an id delimiter in its call pattern, you must prefix the 
delimiter with the commercial at symbol (@). You must separate the id delimiter 
from the macro identifiers (formal parameters or macro name) by a blank character. 
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When calling a macro defined with id delimiters, an implied blank delimiter is 
required to precede the id delimiter, but none is required to follow the id delimiter. 
The @ is not required. 

An example of a macro defined with id delimiters is: 

%*DEFINE(ADD P1 3T0 P2 3AND P3) ( 

MOV AX, %P1 

MOV BX, AX 

ADD AX, %P2 

MOV %P2, AX 

MOV AX, BX 

ADD AX, %P3 

MOV %P3, AX 
) 

The following call: 

% A D D ATOM TO MOLECULE AND CRYSTAL 

returns this code when expanded: 

MOV AX, ATOM 

MOV BX, AX 

ADD AX, MOLECULE 

MOV MOLECULE, AX 

MOV AX, BX 

ADD AX, CRYSTAL 

MOV CRYSTAL, AX 

The call could also have been written 

% A D D ATOM TOMOLECULE ANDCRYSTAL 



Literal Delimiters 

The delimiters used when we documented user-defined macros (parentheses and 
commas) were literal delimiters. A literal delimiter can be any character except the 
metacharacter. 

When you define a macro using a literal delimiter you must use exactly that delimiter 
when you call the macro. If you do not include the specified delimiter character as it 
appears in the definition, it will generate a macro error. 

When defining a macro, you must literalize the delimiter string, if the delimiter you 
wish to use meets any of the following conditions: 

• uses more than one character, 

• uses a macro identifier character (A-Z, 0-9, _. , or ?), 

• uses a commercial at (@), 

• uses a space, tab, carriage-return, or linefeed. 



7-21 



The Macro Processing Language ASM86 

You can use the escape function (°kn) or the bracket function (%()) to literalize the 
delimiter string. Several examples of definitions and calls using a variety of literal 
delimiters are shown below: 

This is the simple form shown earlier: 

Before Macro Expansion After Macro Expansion 

%*DEFINE(MAC(A,B)) (%A %B) -> null string 

%MAC(4,5) -» 4 5 

In the following example brackets are used instead of parentheses. The commercial 
at symbol separates parameters: 

%*DEFINE(MOV[A%( 5) )B]) (MOV [%A ] , %B) 

% M V E B X 3 DI] -> MOVIBX] ,DI 

In the next two examples delimiters that could be id delimiters have been defined as 
literal delimiters (the differences are noted): 

%*DEF INE (ADD ( A% ( AND) B) ) ( ADD %A,%B) -> null string 
% A D D ( AX AND 5) -> ADD AX, 5 

To illustrate the differences between id delimiters and literal delimiters, consider the 
following macro definition and call. (A similar macro definition is discussed with id 
delimiters): 

%*DE F I NE ( ADD P1 %(T0) P2 %(AND) P3 ) ( 

MOV AX, %P1 

MOV BX, AX 

ADD AX, %P2 

MOV %P2, AX 

MOV AX, BX 

ADD AX, %P3 

MOV %P3, AX 
) 

The following call: 

%ADD COUNT TO INCR AND FACTOR 

returns this code when expanded 

MOV AX, COUNT 

MOV BX, AX 

ADD AX, INCR 

MOV INCR, AX 

MOV AX, BX 

ADD AX, FACTOR 

MOV FACTOR, AX 

If the parameters contain strings that match the delimiters, i.e., if %P1 is ATOM, 
you will get incorrect results. 

Literal vs. Normal Mode 

In normal mode the macro processor scans text looking for the metacharacter. 
When it finds one, it begins expanding the macro call. Parameters are substituted 
and macro calls are expanded. This is the usual operation of the macro processor, 
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but sometimes it is necessary to modify this mode of operation. The most common 
use of the literal mode is to prevent macro expansion. The literal character in 
DEFINE prevents the expansion of macros in the macro-body until you call the 
macro. 

When you place the literal character in a DEFINE call, the macro processor shifts to 
literal mode while expanding the call. The effect is similar to surrounding the macro 
body with the bracket function. The escape, comment, and bracket functions arc 
expanded; but no further processing is performed. Any calls to other macros arc not 
expanded. 

If there are no parameters in the macro being defined, the DEFINE built-in function 
can be called without the literal character. If the macro uses parameters, the macro 
processor will attempt to evaluate the formal parameters in the macro-body as 
parameterless macro calls. 

The following example illustrates the difference between defining a macro in literal 
mode and normal mode: 

% S E T ( T M , 1 ) 

%*DEFINE(AB) ( % E V A L (%T0M) ) 
% D E F I N E ( C D ) (%EVAL(%T0M)) 

When AB and CD are defined, TOM is equal to 1. The macro body of AB has not 
been evaluated due to the literal character, but the macro body of CD has been com- 
pletely evaluated, since the literal character is not used in the definition. Changing 
the value of TOM has no affect on CD, it changes the return value of AB as 
illustrated below: 

Before Macro Expansion After Macro Expansion 

%SET(T0M,2) 

%AB -* 02H 

%CD -> 01 H 

The macros themselves can be called with the literal character. The return value then 
is the unexpanded body: 

%*CD -> 01 H 

%*AB -> %EVAL(%T0M) 

The literalized calls to AB and CD show that CD evaluates to 01 H, while AB con- 
tains a macro call to EVAL with a /oTOM as its parameter. 



Algorithm for Evaluating Macro Calls 

The algorithm the macro processor uses for evaluating the source file can be seen in 
6 steps: 

1 . Scan the source until the metacharacter is found. 

2. Isolate the call pattern. See note below. 

3. If macro has parameters, expand each parameter from left to right (initiate step 
one on actual parameter) before expanding the next parameter. 

4. Substitute actual parameters for formal parameters in macro body. 

5. If the literal character is not used, initiate step one on macro body. 

6. Insert the result into output stream. 
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NOTE 

When isolating the call pattern, the macro processor is actually 
scanning input for the specified delimiter. All text found between 
delimiters is considered the actual parameter. For this reason Id 
delimiters need not be terminated by spaces in a call. 

The terms 'input stream' and 'output stream' are used, because the return value of 
one macro may be a parameter to another. On the first iteration, the input stream is 
the source file. On the final iteration, the output stream is passed to the assembler. 

The examples below illustrate the macro processor's evaluation algorithm: 

%SET(T0M,3) 

%*DEFINE(STEVE) ( % S E T (TOM , XTOM-1 ) %T0M) 

%*DEFINE(ADAM(A,B)) ( 

DB %A, %B, %A, %B, %A, %B 

) 

Here is a call ADAM in the normal mode with TOM as the first actual parameter 
and STEVE as the second actual parameter. The first parameter is completely 
expanded before the second parameter is expanded. After the call to ADAM has 
been completely expanded, TOM will have the value 02H . 

Before Macro Expression After Macro Expression 

%ADAM(%TOM,%STEVE) -> DB 03H, 02H, 03H, 02H, 03H, 02H 

Now reverse the order of the two actual parameters. In this call to ADAM, STEVE 
is expanded first (and TOM is decremented) before the second parameter is 
evaluated. Both parameters have the same value. 

%SET(T0M,3) 

%ADAM(°/.STEVE,%TOM) -> DB 02H, 02H, 02H, 02H, 02H, 02H 

Now we will literalize the call to STEVE when it appears as the first actual 
parameter. This prevents STEVE from being expanded until it is inserted in the 
macro body, then it is expanded for each replacement of the formal parameters. 
Tom is evaluated before the substitution in the macro body. 

%SET(T0M,3) 

%ADAM(°/.*STEVE,%TOM) -> DB 02H, 03H, 01H, 03H, 00H, 03H 
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This chapter describes codemacros, which define 8086, 8087, and 8088 instructions. 
Codemacros should not be confused with macros, which are described in Chapter 7. 

A codemacro is a preset body of code which you define, a skeleton in which most 
instructions and values are fixed. They are automatically assembled wherever the 
macro is invoked (used as an instruction), which saves your rewriting them every 
time that sequence is needed. 

However, certain names used in the definition are NOT fixed. They are stand-ins, 
which are replaced by names or values that you supply in the same line that invokes 
the codemacro. These stand-ins are called "dummy" or "formal" parameters. They 
simply "hold the place" for the actual parameters to come. Formal parameters thus 
indicate where and how the actual parameters are to be used. 

You invoke the codemacro by using its name as an instruction. For example: 



MOV BX, W0RD3 

MAC1 PARAM1, PARAM2 

ADD AX, W0RD4 



MAC1 above represents the use of some codemacro you defined earlier. It appar- 
ently requires 2 parameters, that is, the definition used 2 formals to be replaced by 
these actual parameters supplied above when you invoke the codemacro. 

In fact, the MOV and ADD instructions above are codemacros. The assembler's 
entire instruction set is defined and implemented as a large number of codemacros. 
(The definitions are at the end of this Appendix). Once you understand how this is 
done, you may add instructions to those supplied as part of the assembler. 

The type of macro used to implement this assembly language is called a codemacro 
to distinguish it from text macros described in Chapter 7. The latter are more 
familiar to programmers because previous assembly languages have included such a 
facility. Text macros are not discussed in this chapter. The presentation below will 
describe creating and using codemacros. 

These codemacros are encoded at codemacro definition time into a very compact 
form, so that all defined codemacros may reside simultaneously in memory. Each 
definition specifies a certain combination of parameters and will match only those. 
Other combinations of parameters may be accommodated by redefining the 
codemacro. Multiple definitions of the same codemacro name are chained together; 
so that when the codemacro is called, each link of the chain can be checked for a 
match of operands. 

Since the 8086 instruction set consists of codemacros, it is natural to refer to a 
codemacro being called as an "instruction," and to refer to its actual parameters as 
"operands." 
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For example, the language has an ADD instruction that works properly with any 
general register or memory location as a destination operand or as a source operand, 
and works with immediate-data operands. This is achieved by defining 11 
codemacros to generate the 1 1 different machine instructions appropriate to these 
different cases and combinations. The correct one is used because the specification 
of its formal parameters is matched by the actual parameters supplied in your source 
code. The details of how this works are covered in this chapter. 

The definition of a codemacro begins with a line specifying its name and a list of its 
formal parameters, if any: 

CODEMACRO name [formal_list] 
or 

CODEMACRO name PREFX 

where formal list is a list of formal parameters, each in the form 

fornrL_name:specifier_letter [modifier„_letter] [range] 

The square brackets indicate optional items; they are not actually used in the state- 
ment that you code. The single word CODEMACRO and the name are both 
required. The formal parameters are optional. If they are present, then each one 
must be followed by one of the specifier letters A, C, D, E, M, R, S, X. After the 
specifier letter comes an optional modifier letter: b, d, q, t, or w. There follows an 
optional range specifier, which consists of a pair of parentheses enclosing either one 
expression, or two expressions separated by a comma. The semantics of specifiers, 
modifiers, and ranges are described below. 

When no formals are used, you may code the keyword PREFX, indicating the code- 
macro is to be used as a prefix to other instructions. This too is optional. Examples 
of prefixes in the 8086 instruction set are LOCK and REP. 

The definition ends with a line as follows: 

ENDM 

Between the first and last lines of a codemacro' definition is the body of the code- 
macro, the actual bit patterns and formal parameters which will be assembled and 
replaced each time the macro is invoked. Only a few kinds of directive are allowed in 
codemacros. They are: 

1. SEGFIX 



2. 


NOSEGFIX 


3. 


MODRM 


4. 


RELB 


5. 


RELW 


6. 


DB 


7. 


DW 


8. 


DD 


9. 


Record initialization 


10. 


RFIX 


11. 


RFIXM 


12. 


RNFIX 


13. 


RNFIXM 


14. 


RWFIX 
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Each of these directives, along with the special expression operand PROCLEN, are 
explained further on in this chapter. 

Some simple examples of codemacros: 

Codemacro STC 

DB 0F9H ; this sets the carry flag (CF) to 1 . 

Endm 

Codemacro PUSHF 

DB 9CH ; pushes all flags into top word on stack. 

Endm 

Codemacro ADD dst:Ab, src:Db 
DB 04H 
DB src 
Endm 

The first two examples simply allow a machine instruction to be invoked by the use 
of a name, which is usually more easily remembered ("mnemonic") than a string of 
numbers. 

The third example is one of the 11 macros defining the ADD instruction, or more 
precisely, defines one of the 1 1 ADD instructions. (There are 1 1 in order to cover all 
the valid combinations of parameters.) It has two formal parameters, called "dst" 
and "src," for destination and source operands. These formals could be called 
anything; for example: 

Codemacro ADD anything:Ab, other:Db 
DB 04H 
DB other 
Endm 

is the identical macro in function and format. 



Specifiers 



Every formal parameter must have a specifier letter, which indicates what type of 
operand is needed to match the formal parameter. There are eight possible specifier 
letters: 

A meaning Accumulator, that is AX or AL. 

C meaning Code, i.e., a label expression only. 

D meaning Data, i.e., a number to be used as an immediate value. 

E meaning Effective address, i.e., either an M (memory address) or an R 
(register). 

F meaning a floating point stack element, i.e., ST or ST(i). 

M meaning a memory address. This can be either a variable (with or without 
indexing) or a bracketed register expression. 

R meaning a general Register only, not an address-expression, not a register 
in brackets, and not a segment register. 

S meaning a Segment register only, either CS, DS, ES, or SS. 

T meaning the floating point stack top, i.e., ST or ST(0). 

X meaning a direct memory reference, a simple variable name with no 
indexing. 
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A more detailed discussion of which operands match which specifier letters appears 
in the instruction-matching section later in this chapter. 

Modifiers 

The optional modifier letter imposes a further requirement on the operand, relating 
either to the size of data being manipulated, or to the amount of code generated by 
the operand. The meaning of the modifier depends on the type of the operand: 

• For variables, the modifier requires the operand to be of a certain TYPE: "b" 
for byte, "w" for word, "d" for dword, "q" for qword, "t" for tbyte. 

• For labels, the modifier requires the object code generated to be of a certain 
amount: "b" for an 8-bit relative displacement on a NEAR label, "w" for 
NEAR labels which are outside the -128 to 127 short displacement range, and 
"d" for FAR labels. 

• For numbers, the modifier requires the number to be of a certain size: "b" for 
-256 through 255, and "w" for other numbers between -65,536 and 65,535. 
The specifier-modifier pairs "Dd"; "Dq" and "Dt" are never matched. 

Note that this manual uses upper-case letters for specifiers and lower-case letters for 
modifiers. This is a useful language convention to clarify the code. However it is not 
required — as in all source code outside of strings, the distinction between upper and 
lower case is ignored by the assembler. 

Range Specifiers 

If a range is specified, it can be a single expression or two expressions separated by a 
comma. Each expression must evaluate to a register or a pure number, i.e., not an 
address. Range specifiers are not allowed with floating point stack elements, that is, 
src=F or T. The list of number values corresponding to range registers is given in the 
instruction-matching section later in this chapter. The following shows the first lines 
(only) of three codemacros in the current language which use range specifiers: 

1 . Codemacro IN dst:Aw,port:Rw(DX) 

2. Codemacro ROR dst:Ew,count:Rb(CL) 

3. Codemacro ESC opcode:Db(0,63),adds:Eb 

The first of these is one of the four codemacros for the IN (input) instruction. It says 
that if a register is to specify the port from which to input a word, only DX will 
match this codemacro. Any other register will fail to match, and the source line will 
be flagged as erroneous (e.g., IN AX,BX is in error). 

The second is one of the four ROtate Right codemacros. It says the word rotated can 
be any word register except a segment register, or any word in memory. It is to be 
rotated right some number of bit positions ("count"), where "count" is specified as 
a byte register, and further specified to be CL. No other register will match (e.g., 
ROR AX, DL is in error). 

The third says the "opcode" supplied as the first parameter to the ESC instruction 
must be a byte of immediate-data of value to 63 inclusive. 

Segfix 

SEGFIX is a directive, included in some codemacro definitions, which instructs the 
assembler to determine whether a segment-override prefix byte is needed to access a 
given memory location. If the override byte is needed, it is output as the first byte of 
the instruction. If it is not needed, no action is taken. 
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The form of the directive is: 

SEGFIX formaLname 

where "formal name" is the name of a formal parameter which represents the 

memory address. Because it is a memory address, the formal must have one of the 
specifiers E, M, or X. 

In the absence of a segment-override prefix byte, the 8086 hardware uses either DS 
or SS. Which one depends on which base register, if any, was used. BP implies SS. 
BX implies DS. No base register also implies DS. (This, of course, includes the three 
possibilities of SI alone, DI alone, or no indexing at all.) The assembler must decide 
whether this hardware-implied segment register is actually the one that will reach the 
intended memory location. 

The assembler examines the segment attribute of the memory-address expression 
provided as the actual parameter. This attribute could be a segment, a group, or a 
segment register. 

• If it is a segment, the assembler determines whether that segment or a group 
containing that segment has been ASSUMEd into the hardware-implied seg- 
ment register. If so, no override byte is needed. If not, the assembler checks the 
ASSUMES of other segment registers, looking for the segment or a group con- 
taining it. If found, the override byte for that segment register is issued. If not 
found, an error is reported. 

• If it is a group, the assembler takes the same action as for a segment, except that 
the possibility of an including group is ruled out: the group itself must be 
ASSUMEd into one of the segment registers. Otherwise an error is reported. 

• If it is a segment register, the assembler sees if it is the hardware-implied 
segment register. If so, no override byte is issued. If not, the override byte for 
the specified segment register is issued. 



Nosegfix 



NOSEGFIX is used for certain operands in those instructions for which a prefix is 
illegal because the instruction cannot use any other segment register but ES for that 
operand. This applies only to the destination operand of these string instructions: 
CMPS, MOVS, SCAS, STOS. 

The form of the directive is: 

NOSEGFIX segreg, formal_name 

where "segreg" is one of the four segment registers ES, CS, SS, DS, and 

"formal name" is the name of a memory-address formal parameter. As a memory 

address, the formal must have one of the specifiers E, M, or X. 

The only action the assembler performs when it encounters a NOSEGFIX in 
assembling an instruction is to perform an error check — no object code is ever 
generated from this directive. 

The assembler looks up the segment attribute of the actual parameter (memory- 
address) corresponding to "formal name." If the attribute is a segment register, it 

must match "segreg." If the attribute is a group, it must be ASSUMEd into 
"segreg." If the attribute is a segment, it or a group containing it must be 
ASSUMEd into "segreg." If these tests fail and "formal name" is thus deter- 
mined not to be reachable from "segreg," an error is reported. 

The only value for "segreg" actually used by the string instructions listed above is 
ES. 
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Modrm 

This directive instructs the assembler to create the ModRM byte, which follows the 
opcode byte on many of the 8086's instructions. The byte is constructed to carry the 
following information: 

1 . The indexing-type or register number to be used in the instruction. 

2. Which register is (also) to be used, or more information to select the instruction. 

The MODRM byte carries the information in three fields: 

The mod field occupies the two most significant bits of the byte, and combines with 
the r/m to form 32 possible values: 8 registers and 24 indexing modes. 

The reg field occupies the next three bits following the mod field, and specifies either 
a register number or three more bits of opcode information. The meaning of the reg 
field is determined by the first (opcode) byte of the instruction. 

The r/m field occupies the three least significant bits of the byte. It can specify a 
register as the location of an operand, or form part of the addressing-mode encoding 
in combination with the mod field as described above. 

The bit patterns corresponding to each indexing mode and register combination are 
given in Chapter 1 and Appendix B. They need not concern you when you are 
writing codemacros, since the assembler takes care of the encoding when you pro- 
vide the operands. 

The form of the directive is: 

MODRM formaLor__number, formal__name 

where "formal or number" is either the name of a formal parameter, or an 

absolute number: and "formal name" is the name of another formal parameter. 

"formal or number" represents the quantity which goes into the reg field of the 

ModRM byte. If it is a number, then that same value is always plugged into the field 
every time that codemacro definition is invoked. The number in this case is a con- 
tinuation of the opcode identifying which instruction the hardware is to execute. 

If it is a formal, then the corresponding operand (usually a register number) is 
plugged in. 

"formal-name" represents an effective-address parameter. The assembler examines 
whether the operand supplied is a register, variable, or indexed variable, and con- 
structs the mod and r/m fields which correctly represent the operand. If the operand 
calls for an 8-bit or 16-bit offset displacement, the assembler generates that as well. 

An example of an 8086 instruction using ModRM: 

Codemacro ADD dst:Rw, src:Ew 

Segfix src 

DB 3 

MODRM dst, src 

Endm 

The specifiers Rw and Ew indicate that this codemacro will match only when the 
actual parameters in the invocation line are a full word general register destination, 
and a full word source, memory or general register. 
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Example 1 : 

ADD DX, CBX] [SI] becomes 

00000011 10010000 
76543210 76543210 

The first byte identifies this as an ADD of a memory word into a register. This par- 
ticular byte covers only 1 of the 4 cases that are possible depending on the lowest 2 
bits. If bit 1 (direction) is a 0, the ADD is FROM a register TO either a register or a 
memory location. If bit 1 is a 1, then the ADD is TO a register FROM a register or 
memory location. The least significant bit, bit 0, tells whether the data being ADDed 
is byte (0) or word (1). 

The second byte is the MODRM byte, with DX encoded as 010 in bits 5, 4, 3, a mode 
of 10 in bits 7, 6, and an RM of 000 (see Chapter 1 or Appendix B for more detail). 

If the source line had included a variable; for example: 

ADD DX, MEMW0RD [BX1 [SI] 

then the offset of MEMWORD (low-order byte first, high byte last) would follow 
the MODRM byte. 

Example 2: 

ADD DX, [DI] 

00000011 10010101 
76543210 76543210 

As a different example, consider a destination of a word in memory and a source of 
immediate-data. The relevant codemacros are: 

Codemacro ADD dst:Ew,src:Dw 

Segf i x dst 

DB81H 

MODRM f dst 

DW src 

Endm 

Codemacro ADD dst : Ew, src : Db (-128, 127) 

Segfix dst 

DB 83H 

MODRM , dst 

DB src 

Endm 

The object code generated for the instruction and data are different in the 2 cases of 
a byte of data or a word of data. 

Furthermore, the MODRM line for these instructions specifies a "for- 
mal or number" field of zero, i.e., 3 bits all zero, whereas the MODRM line for 

the two examples above specified a field of dst, which became 010 to represent DX. 

Example 3: 

ADD [DI], 513 

10000001 10000101 00000001 00000010 
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Example 4: 



ADD BYTE PTR [BX] [SI] , 4 
10000011 10000000 00000100 

The immediate-data byte or word follows the MODRM byte. 



Relband Relw 

These directives, used in calls and jumps, instruct the assembler to generate the 
displacement between the end of the instruction and the label which is supplied as an 
operand. This means RELB generates the 1 byte (and RELW the 2 byte) displace- 
ment, or distance in bytes, between the instruction pointer value (at the end of the 
codemacro) and the destination address. 

The directives have the following form: 

RELB formal „name 
or 

RELW formal___name 

where "formal name" is the name of a formal with a "C" (Code) specifier. 

The assembler assumes that all RELB and RELW directives occur immediately after 
a single opcode byte in the codemacro (as in all the JUMP and CALL instructions in 
the 8086 instruction set). It needs this assumption to determine (during codemacro 
matching) where the displacement starts from, so that an operand can be identified 
as "Cb" or "Cw." Although the assembler allows you to define codemacros in 
which RELB and RELW occur elsewhere in the definition (e.g., a multi-instruction 
codemacro), you run the risk of making the wrong match when the codemacro is 
invoked. If a "b" is thus matched as "w," a wasted byte is generated; if a "w" is 
thus matched as a "b," an error is reported. 

Examples of RELB and RELW as they appear in the 8086 instruction set are: 

Codemacro J M P place:Cw 
DB 0E9H 
RELW place 
Endm 

Codemac ro J E p Lace : Cb 
DB 74H 
RELB place 
Endm 

These are direct jumps to labels in the CS segment. The specifier on the formal 
parameter of the first macro calls for a NEAR label in the current CS segment (Cd 
would mean FAR). This means a 16 bit offset, able to reach any byte in the 
immediate 64K bytes of address higher than the start of the segment. RELW com- 
putes the distance and provides it as a word to follow the 0E9H instruction byte. 

If the offset of the target is 513, then this codemacro would generate the instruction: 

11101001 00000001 00000010 
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The distance begins at the end of that RELW word, i.e., if you were counting the 
bytes to that label, the first byte counted would be the one after the 3 bytes compris- 
ing this jump. 

NOTE 

A match only occurs if the label was assembled under the same ASSUME 
CS:name as the jump. Only if there is a match is object code actually 
generated. 

The second example is a conditional jump, executed only if its conditions are met. In 
this case, a Jump if Equal, the jump occurs if ZF=0. Conditional jumps are always 
self-relative and limited to destinations whose distance can fit in 1 byte. This means 
destinations no further ahead than 127 bytes and no further behind this instruction 
than -128 bytes. 

If the target is 99 bytes ahead, then this codemacro would generate the instruction: 

01110100 01100011 

The distance counted begins with the byte after these 2 bytes above. 



DB, DW, andDD 

These directives are similar to the DB, DW, and DD directives which occur outside 
of codemacro definitions (see Chapter 3); however, there are some differences in the 
operands they accept. 

The form of the directives is: 

DB cmac_expression 
or 

DW cmac_expression 
or 

DD cmac_expression 

where cmac expression is either an expression without forward references which 

evaluates to an absolute number; a formal parameter name; or a formal parameter 
name with a dot-recordfield shift construct. 

An absolute number means that the same value is to be assembled every time this 
codemacro definition is invoked. A formal parameter means that the corresponding 
actual operand is to be assembled. A dot-recordfield shift construct means that the 
actual operand is to be shifted and then plugged in, as discussed later in this chapter. 

The operands to these codemacro initializations are restricted, in that lists and DUP 
counts are not allowed. 

Note that the DO and DT directive are not allowed inside codemacro definitions. 



Record Initializations 

The record initialization directive allows you to control bit fields smaller than one 
byte in codemacro definitions. The form of the directive is: 

record_name [cmac__expression_list] 
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where record name is the name of a previously-defined record (see Chapter 3), and 

cmac expression list is a list of cmac expressions, separated by commas. (These 

particular square brackets are not used in writing the list; their meaning here is that 

the list is optional.) A cmac expression is, as in the above section, either a number, 

a formal, or a shifted formal. In addition, null cmac expressions are allowed in the 

list; in which case the default record field value as specified in the RECORD defini- 
tion is used. 

The directive instructs the assembler to put together a byte or a word (depending on 
the record), using the constant numbers and supplied operands as specified in the 
expression list. The values to be plugged in might not fit into the record fields; in 
that case, the least significant bits are used, and no error is reported. In addition, a 
record initialization is subject to the following limitation: the number of fields in the 
record definition plus the number of fields being initialized by absolute numbers (by 
default or given), plus the number of fields initialized by shifted formal parameters 
cannot exceed 14. 



RFIX 

RFIX is a directive which generates two bytes: an 8086/8088 WAIT instruction 
(1001 101 IB) followed by the first byte of an 8086/8088 ESCAPE instruction (1 101 1 
XXXB). The form of the directive is: 

RFIX formaLor__number 

where "formal or number" is either the name of a formal parameter with 

specifier D or an absolute number. The value of "formal or number" specifies 

the low-order three bits of the second byte generated. 

As an example of the use of RFIX, consider the codemacro for the 8087 instruction 
FLD1: 

Codemacro FLD1 

RFIX 001B 

DB 1110 1000B 
ENDM 

The source statement instruction FLD generates: 

1001 1011 11011001 1110 1000 

The first byte is an 8086/8088 WAIT instruction. The second byte is the first byte of 
an 8086/8088 ESCAPE instruction. The low-order three bits of the second byte, 
followed by the third byte, identify this as an FLD1 instruction. 



RFIXM 

RFIXM is a directive which generates the same two bytes as RFIX, but also instructs 
the assembler to determine whether a segment-override byte is needed to access a 
given memory location. The form of the RFIXM directive is: 

RFIXM formaLor^number, formaLname 

where "formal or number" is either the name of a formal parameter with 

specifier D or an absolute number, and 'formal name' is the name of a formal 

parameter which represents a memory address; that is, its specifier must be 'E', 'M' 
or'X'. 
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If the memory address uses the default segment register, no segment-override byte is 
needed and RFIXM generates the same two bytes as RFIX. 

If the memory address requires a segment-override byte, RFIXM generates three 
bytes: an 8086/8088 WAIT instruction, a segment-override byte (001 reg 1 10B), and 
the first byte of an 8086/8088 ESCAPE instruction. Note that the segment-override 
byte is the second byte generated, not as SEGFIX would generate, the first. 

(See the discussion of SEGFIX for information on how the assembler determines 
whether or not a segment-override byte is necessary.) 

As an example of the use of RFIXM, consider one of the codemacros for the 8087 
instruction F ADD: 



Codemacro FADDmemop:Mq 

RFIXM 100B, memop 

ModRM 000B, memop 
EndM 

The source statement instruction FADD QUAR [BX] generates the following bytes: 

1001 1011 00100110 11011100 00001010 

The first byte is an 8086/8088 WAIT instruction. The second byte is the segment- 
override byte, specifying ES (reg=00). The third, fourth and fifth bytes identify the 
floating point instruction as FADD, with a memory operand pointed to by BX, with 
a displacement of 10. QUAR becomes a QWORD variable at offset 10 from a seg- 
ment ASSUMED into the ES register only. 



RNFIX 

The RNFIX directive generates two bytes: an 8086 NOP instruction (1001 0000B) 
followed by the first byte of an 8086/8088 ESCAPE instruction (11011 XXXB). 
RNFIX functions like RFIX, except that a NOP instruction is the first byte 
generated, rather than a WAIT instruction. The format of the RNFIX directive is: 



RNFIX formal_or_.number 

where "formal or number" is either the name of a formal parameter with 

specifier D or an absolute number. The value of "formal or number" specifies 

the low-order three bits of the second byte generated. 

As an example of the use of RNFIX, consider the codemacro for the 8086 instruc- 
tion FNCLEX: 



Codemacro FNCLEX 

RNFIX 01 1 B 

DB 111 000 10B 
EndM 

The source statement instruction FNCLEX generates the following three bytes: 

1001 0000 11011011 11100010. 
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RNFIXM 

RNFIXM is a directive which generates the same two bytes as RNFIX, but also 
instructs the assembler to determine whether a segment-override byte is needed to 
access a given memory location. RNFIXM functions like RFIXM, except that a 
NOP instruction is the first byte generated, rather than a WAIT instruction. The 
format of the RNFIXM directive is: 

RNFIXM formal _or__number, formaLname 

where "formal or number" is either the name of a formal parameter with 

specifier D or an absolute number and 'formal name' is the name of a formal 

parameter which represents a memory address, that is, its specifier must be 'E', 'M' 
or'X'. 

If a segment-override byte (001 reg HOB) is needed to address "formal name," it 

immediately follows the first byte generated, i.e., the NOP instruction. 

As an example of the use of the RNFIXM directive, consider the codemacro for the 
8087 instruction FNSAVE: 

Codemacro FNSAVE memoprM 

RNfixM 101B, memop 

ModRM 110B, memop 
EndM 

The source statement instruction FNSAVE WORD PTR SS:[BX] generates the 
following bytes: 

1001 0000 00110110 11011 1101 0011 0111 

Note that the segment-override byte (0011 0110B) follows the NOP instruction 
(10010000). 



RWFIX 

The RWFIX directive generates an 8086/8088 WAIT instruction (1001 101 IB). The 
format of this directive is: 



RWFIX 



NOTE 



The preceding descriptions assume that the generated code is to be linked 
with the 8087 chip library (8087. LIB). If the code is linked instead with the 
8087 emulator library (E8087.LIB), an emulator instruction is generated 
instead of an 8087 instruction. The emulator instruction differs from the 
8087 instruction in the first two bytes of code. The correct instruction may 
not be determined until the program is actually linked so the Assembler 
listing will always show the 8087 instructions. 

Using the Dot Operator to Shift Parameters 

A special construct allowed as the operand to a DB, DW, or DD, or as an element of 
the operand to a record initialization, is the shifted formal parameter. The form of 
this construct is: 

formaLname.record__field_name 
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where formal name is the name of a formal whose corresponding operand will be 

an absolute number; and record field name is the name of a record field. The 

assembler evaluates this expression when the codemacro is invoked, by right-shifting 
the operand provided using the shift count defined by the record field. 

The example in the 8086 instruction set where this feature is used is the ESC instruc- 
tion, which permits communication with other devices using the same bus. Given an 
address, ESC puts that address on the bus; given a register operand, no address is 
put on the bus. This enables execution of commands from an external device both 
with or without an associated operand. These commands are represented in the ESC 
codemacro as numbers between and 63 inclusive. The interpretation of the number 
is done by the external device. 

R53 Record RF1 :5, RF2:3 

R233 Record RF6:2, mid3:3, RF7:3 

Codemacro ESC opcode : Db (0 , 63) , addr:E 

S eg f i x addr 

R53 <11011B, opcode. mid3> 

ModRM opcode, addr 

EndM 

The R53 line in the body of the codemacro generates 8 bits as follows: the high-order 
5 bits become 1101 IB, and the low-order 3 bits are filled with the actual parameter 
supplied as "opcode" shifted right by the shift count of mid3, namely 3. 

Example: 



Assume that you wish to use ESC with an "opcode" of 39 on an "addr" of MEM- 
WORD, whose offset is 477H in ES, indexed by DI. 

ESC 39, ES: MEMWORD [DI] 

SEGFIX addr becomes ES: = 0010 0110B 

39 = 00100111 B 

opcode. MID3 = (000)00100 

R53CI1011B, opcode. mid3> becomes 110 11100 

for[DI],MOD = 10,R/M=101 

MODRM opcode, addr puts "opcode" into bits 5, 4, 3 of the modrm byte, with bits 
7, 6, 2, 1, filled by the appropriate mod and R/M from "addr." Since opcode is 6 
bits and the field is only 3 bits wide, only the low-order 3 are used, namely 111, and 
the high-order bits (100) aire ignored. 

Therefore MODRM opcode, addr becomes 1011 1101B followed by the offset of 
MEMWORD, 01110111 0000 0100. 

Therefore the full object code for this ESC source line is: 

0010 0110 (bytel) 

1101 1100 (byte 2) 

1011 1101 (byte 3) 

0111 0111 (byte 4) 

0000 0100 (byte 5) 

Note that opcode's 6 bits are split between the last 3 bits of byte 2 and bits 5, 4, 3 of 
byte 3. 
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PROCLEN 

This special operand equals if the current PROC is declared NEAR, and OFFH if it 
is declared FAR. Code outside of PROC...ENDP blocks is considered NEAR. The 
RET codemacros use this operator in creating the correct machine instructions to 
return from a CALL to a NEAR or FAR procedure: 

Codemacro RET 

R413 <0CH, PROCLEN, 3> 

Endm 

Instead of the more familiar DB or DW storage allocation commands, this 
codemacro makes use of a previously defined record. It is used here the same way a 
DB would be, but with the initialization given inside angle brackets to show that 
each field in the record gets its own initial value. You can tell there are at least 3 
fields in the record (if this invocation validly matches the definition, i.e., is not an 
error) because 3 values are given, separated by commas. 

Four such records are defined as one of the first acts of the assembler, to be used in 
defining its instruction set. They are listed in APPENDIX A along with the 
codemacros for ASM86: 

R53 Record RF1 :5, RF2:3 

R323 Record RF3:3, RF4:2, R F 5 : 3 

R233 Record RF6:2, Mid3:3, RF7:3 

R413 Record RF8:4, RF9:1 , RF10:3 

The last line above, R413, defines an 8 bit record of 3 fields: the high-order 4 bits (7, 
6, 5, 4) called RF8, the next (bit 3) called RF9, and the low-order 3 (bits 2, 1,0) 
called RF10. (When R413 is used as a storage allocation command, initial values for 
all fields must be specified within angle brackets because none were specified in the 
definition.) 

In the codemacro for RET, the field RF8 is set to OCH = 1100, and RF10 is set to 
3 = 011. Field RF9, which becomes bit 3 of the allocated record byte, will be if the 
current PROC (in which the RET appears) is typed NEAR, or it will be 1 if the 
PROC is typed FAR. 

Note that PROCLEN is defined to give 8 bits, all zeros or all ones, but that R413 
uses only one bit. The field size determines how many bits are used, and if more are 
supplied then the high-order bits are ignored beyond the field width. 

Matching of Instructions to Codemacros 

This section describes what might aptly be termed the heart of the 8086 assembly 
language. The careful ordering of the chain of codemacro definitions of a given 
instruction (for example, the ADD instruction) combines with the varied set of typ- 
ing requirements on the operands to produce a single assembly language instruction 
mnemonic which represents many hardware instructions. 

The algorithm for matching an instruction to a particular codemacro definition is as 
follows: 

1 . In pass 1, actual parameters are evaluated. Those containing forward references 
are treated as a special type, as described in each of the cases below. 

2. If any of the actual parameters (when there are more than one) is a register 
expression without an associated type (e.g., [BX]), or if an implicit reference to 
the accumulator is made (e.g., "MOV, 3"), then the other parameters are 
checked to see if at least one contains an unambiguous modifier type. Numbers 
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matching "b" do not suffice; but numbers matching "w," explicitly-given 
registers, and all typed variables do suffice to distinguish the modifier type. If 
no such parameter is found, the error message "INSUFFICIENT TYPE 
INFORMATION TO DETERMINE CORRECT INSTRUCTION" is issued, 
and no match is attempted. Note that a single, untyped, register expression 
parameter (as in FSTENV [BX]) is allowed. 

3. The chain of codemacro definitions for a given instruction is searched for a 
match, beginning with the last one defined and working backwards. In order for 
a definition to match, the number of actual parameters must match the number 
of formals in the particular definition, and each actual must match the formal in 
specifier type, modifier (if given in the formal), and range (if given in the for- 
mal). The run-down of which actuals match which formals is as follows: 

a. SPECIFIERS. 

Forward references in pass 1 match C,D,E,M,X. 

AX and AL match A,E,R. 

Labels match C. 

Numbers match D. 

Non-indexed variables match E,M,X. 

Indexed variables and register expressions match E,M. 

Registers except segment registers match E,R. 

Segment registers CS,DS,ES,SS match S. 

Floating-point stack element 

(ST, ST(0), ..., ST(7)) match F. 
The floating-point stack top 

(ST, ST(0)) match T. 

b. MODIFIERS. 

The nature of modifier-matching depends on what the matched specifier is. 
For numbers: Numbers between -256 and 255 match "b" only. Other 

numbers match "w" only. 
For labels: NEAR labels with the SAME CS-assume which are in the range 
-126 to +129 from the beginning of the codemacro match "b" only. 

Other NEAR labels with the same CS assume match "w" only. 

NEAR labels with a different CS-assume match no modifier. 

FAR labels match "d". 
For variables: Type BYTE matches "b." 

Type WORD matches "w." 

Type DWORD matches "d." 

Type QWORD matches "q." 

Type TBYTE matches "t." 

Other numeric types match no modifier. 
Forward references match any modifier, except when typing information is 

attached, with BYTE PTR, SHORT, FAR PTR, etc. 
Index-register expressions without a type associated with them (e.g., [BX]) 

match either "b" or "w" when used with another operand of type 

"b" or "w" and matches no modifier for single-operand instructions. 

c. RANGES. 

Range specifiers are legal only for parameters which are numbers or 
registers (specifiers A, D, R, S). If one specifier follows the formal, the 
value of the actual must match; if two follow the formal, the value must fall 
within the inclusive range of the specifiers. For this matching, registers 
which are passed as actuals assume the following numeric values: 



AL: 





CL: 


1 


DL: 


2 


BL: 


3 


AH: 


4 


CH: 


5 


DH: 


6 
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BH: 


7 


AX: 





CX: 


1 


DX: 


2 


BX: 


3 


SP: 


4 


BP: 


5 


SI: 


6 


DI: 


7 


ES: 





CS: 


1 


SS: 


2 


DS: 


3 



Forward references do not match the formal if there is a range specifier. 

4. If a match is found, the number of bytes of object code generated is estimated. 
Forward-reference variables, unless explicitly overridden, are assumed not to 
need a segment override byte. ModRMs involving forward references are 
assumed to require 16-bit displacements, except if the reference has SHORT, in 
which case an 8-bit displacement is assumed. 

5. In pass 2, the search through the codemacro chain starts all over again, starting 
at the end of the chain and working backwards just as in pass 1 . The resolution 
of codemacro parameters which were forward references in pass 1 might cause a 
different codemacro to be matched in pass 2. 

6. Object code generated by the instruction is issued in pass 2. If the number of 
bytes output exceeds the pass 1 estimate, an error message is issued and the extra 
bytes are withheld. The instruction is thus incomplete and the program should 
not be executed. If the number of bytes is less than the pass 1 estimate, the 
remaining space is padded with 90H's (NOP; i.e., no operation). 

The ADD instruction (like many other instructions) provides an excellent example of 
codemacro matching. The 11 codemacro definitions of the ADD instruction cover 
the following cases: 

DESTINATION SOURCE 

1. BYTE MEMORY IMMEDIATE BYTE 

2. WORDMEMORY IMMEDIATE BYTE (not between -128 and 127) 

3. WORD MEMORY IMMEDIATE BYTE (from -128 to 127) 

4. WORDMEMORY IMMEDIATE WORD 

5. AL IMMEDIATE BYTE 

6. AX IMMEDIATE BYTE 

7. AX IMMEDIATE WORD 

8. MEMORY BYTE OR BYTE-REGISTER BYTE-REGISTER 

9. MEMORY WORD OR WORD-REGISTER WORD-REGISTER 

10. BYTE-REGISTER MEMORY BYTE OR BYTE-REGISTER 

11. WORD-REGISTER MEMORY WORD OR WORD-REGISTER 

Each of the above English-language phrases is abbreviated in the codemacro defini- 
tions into a two-letter specifier-modifier combination. Once you are used to the 
abbreviations, the codemacros themselves are easier to scan and understand than the 
above English summary. Here are the first lines of each codemacro described above, 
in the same order, with an English reminder of its meaning, using EA to represent an 
effective address expression resolving to either a memory or register reference: 

1. CodeMacro ADDdst:Eb, src:Db (TO EA byte FROM data byte) 

2. CodeMacro ADD dst:Ew, src:Db (TO EA word FROM large data 

byte) 
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3. CodeMacro ADD dst:Ew, src:Db (-128,127) 



4. CodeMacro 

5. CodeMacro 

6. CodeMacro 

7. CodeMacro 

8. CodeMacro 

9. CodeMacro 

10. CodeMacro 

11. CodeMacro 



ADD dst:Ew, src:Dw 
ADDdstAb, src:Db 
ADDdst:Aw, src:Db 
ADD dst:Aw, src:Dw 
ADDdst:Eb, src:Rb 
ADDdst:Ew, src:Rw 
ADDdst:Rb, src.Eb 
ADD dst:Rw, src:Ew 



(TO EA word FROM signed data 
byte) 

(TO EA word FROM data word) 

(TO AL FROM data byte) 

(TO AX FROM data byte) 

(TO AX FROM data word) 

(TO EA byte FROM register byte) 

(TO EA word FROM register word) 

(TO register byte FROM EA byte) 

(TO register word FROM EA word) 



The ordering of the codemacros is crucial. For example, the instruction "ADD 
AX, 3" matches not only definition #6, but also definition #2, since as a register, AX 
qualifies as an Ew as well as an Aw. Since definition #6 produces less object code, it 
should be selected before definition #2. Hence, it is given later, so that when the 
assembler searches backwards from #11 up, it comes across #6 first. 

Assuming that the following user symbols have been defined with the following 
attributes: 



BYTE_VAR 
WORD_VAR 
WORD_EXPR 
B_ARRAY 



byte variable 
word variable 

memory-address expression 
byte variable 



The following assembler instructions would match the indicated codemacro defini- 
tion line above: 

ADD AX, 250 -> 6 

ADD AX, 350 -» 7 

ADD BX,W0RD_EXPR -> 11 

ADD BX,DX -> 11 

ADD BYTE_VAR,AL -> 8 

ADD BYTE_VAR,254 -> 1 

ADD W0RD_VAR,CX -» 9 

ADD DH,BARRAYtSI] -» 10 

ADD CL,BYTE_VAR -» 10 

ADD AL,3 -> 5 

ADD W0RD_VAR f .35648-> 4 

ADD W0RD_VAR, OFFSET B_ARRAY -> 4 

ADD [BX] [SI] , AH -> 8 

ADD [BP] ,CL -> 8 

ADD DX, [DI] -> 11 

ADD AX, [SI] [BP] -> 11 

ADD W0RD_VAR,3 -» 3 

ADD WORD_VAR,255 -> 2 

NOTE 

Each codemacro is limited to a maximum of 128 internal bytes, which is 
reached at approximately 60 bytes of generated object code. 
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; 8086/186 and 8087 Codemacro Definitions 



CodeMacro Adc dst : Ew, src : Rw 

Segfix dst 

DB 11H 

ModRM src, dst 
EndM 



R5-3 Record RF1:5,RF2:3 

R323 Record RF3 : 3 , RF4 : 2 ,RF5 : 3 

R233 Record RF6 : 2 ,Mid3 : 3 , RF7 : 3 

R413 Record RF8 : 4 , RF9 : 1 ,RF10: 3 

; 8086/186 Codemacros: 



CodeMacro Adc dst : Rb,src: Eb 

Segfix src 

DB 12H 

ModRM dst, src 
EndM 



CodeMacro AAA 

DB 37H 
EndM 

CodeMacro AAD 

DW 0AD5H 
EndM 

CodeMacro AAM 

DW 0AD4H 
EndM 

CodeMacro AAS 

DB 3FH 
EndM 



CodeMacro Adc dst : Rw, src : Ew 

Segfix src 

DB 13H 

ModRM dst, src 
EndM 



CodeMacro Add dst : Eb,src:Db 

Segfix dst 

DB 80H 

ModRM 0,dst 

DB src 
EndM 



CodeMacro Adc dst : Eb,src :Db 

Segfix dst 

DB 8 0H 

ModRM 2, dst 

DB src 
EndM 



CodeMacro Add dst : Ew, src :Db 

Segfix dst 

DB 81H 

ModRM 0,dst 

DW src 
EndM 



CodeMacro Adc dst : Ew,src :Db 

Segfix dst 

DB 81H 

ModRM 2, dst 

DW src 
EndM 

CodeMacro Adc dst : Ew, src : Db (-128 , 127) 

Segfix dst 

DB 8 3H 

ModRM 2, dst 

DB src 
EndM 

CodeMacro Adc dst : Ew, src :Dw 

Segfix dst 

DB 81H 

ModRM 2, dst 

DW src 
EndM 

CodeMacro Adc dst : Ab,src :Db 

DB 14H 

DB src 
EndM 

CodeMacro Adc dst : Aw, src : Db 

DB 15H 

DW src 
EndM 

CodeMacro Adc dst : Aw, src: Dw 

DB 15H 

DW src 
EndM 

CodeMacro Adc dst : Eb,src: Rb 

Segfix dst 

DB 10H 

ModRM src, dst 
EndM 



CodeMacro Add dst : Ew, src : Db (-128 , 127) 

Segfix dst 

DB 8 3H 

ModRM 0,dst 

DB src 
EndM 



CodeMacro Add dst : Ew, src : Dw 

Segfix dst 

DB 81H 

ModRM 0,dst 

DW src 
EndM 



CodeMacro Add dst : Ab,src: Db 
DB 04H 
DB src 

EndM 



CodeMacro Add dst : Aw, src :Db 

DB 05H 

DW src 
EndM 



CodeMacro Add dst : Aw, src:Dw 

DB 5H 

DW src 
EndM 



CodeMacro Add dst : Eb,src : Rb 

Segfix dst 

DB 

ModRM src, dst 
EndM 
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CodeMacro Add dst: 

S eg f i x dst 

DB 1 

ModRM src,dst 
EndM 

CodeMacro Add dst: 

Segfix src 

DB 2 

ModRM dst, src 
EndM 

CodeMacro Add dst: 

Segfix src 

DB 3 

ModRM dst, src 
EndM 

CodeMacro And dst: 

Segfix dst 

DB 8 0H 

ModRM 4, dst 

DB src 
EndM 

CodeMacro And dst: 

Segfix dst 

DB 81H 

ModRM 4, dst 

DW src 
EndM 

CodeMacro And dst: 

Segfix dst 

DB 81H 

ModRM 4, dst 

DW src 
EndM 

CodeMacro And dst: 

DB 24H 

DB src 
EndM 

CodeMacro And dst: 

DB 2 5H 

DW src 
EndM 

CodeMacro And dst: 

DB 2 5H 

DW src 
EndM 

CodeMacro And dst: 

Segfix dst 

DB 2 0H 

ModRM src, dst 
EndM 

CodeMacro And dst: 

Segfix dst 

DB 21H 

ModRM src, dst 
EndM 

CodeMacro And dst: 

Segfix src 

DB 2 2H 

ModRM dst, src 
EndM 

CodeMacro And dst: 

Segfix src 

DB 2 3H 

ModRM dst, src 
EndM 



Ew, src : Rw 



Rb,src:Eb 



Rw, src : Ew 



Eb,src:Db 



Ew,src:Db 



Ew,src : Dw 



Ab,src:Db 



Aw, src :Db 



Aw, src :Dw 



Eb,src: Rb 



Ew,src: Rw 



Rb,src:Eb 



Rw, src : Ew 



BOUND at end 

CodeMacro Call addrrEw 

Segfix addr 

DB 0FFH 

ModRM 2, addr 
EndM 

CodeMacro Call addr: Ed 

Segfix addr 

DB 0FFH 

ModRM 3, addr 
EndM 

CodeMacro Call addr:Cd 

DB 9AH 

DD addr 
EndM 

CodeMacro Call addr:Cb 

DB 0E8H 

RelW addr 
EndM 

CodeMacro Call addr:Cw 

DB 0E8H 

RelW addr 
EndM 

CodeMacro CBW 

DB 98H 
EndM 

CodeMacro CLC 

DB 0F8H 
EndM 

CodeMacro CLD 

DB 0FCH 
EndM 

CodeMacro CLI 

DB 0FAH 
EndM 

CodeMacro CMC 

DB 0F5H 
EndM 

CodeMacro Cmp dst : Eb,src : Db 

Segfix dst 

DB 80H 

ModRM 7, dst 

DB src 
EndM 

CodeMacro Cmp dst : Ew, src :Db 

Segfix dst 

DB 81H 

ModRM 7, dst 

DW src 
EndM 

CodeMacro Cmp dst : Ew, src : Db (-128 , 127) 

Segfix dst 

DB 8 3H 

ModRM 7, dst 

DB src 
EndM 

CodeMacro Cmp dst : Ew, src : Dw 

Segfix dst 

DB 81H 

ModRM 7, dst 

DW src 
EndM 
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CodeMacro Cmp dst : Ab,src :Db 

DB 3CH 

DB src 
EndM 

CodeMacro Crap dst : Aw, src : Db 

DB 3DH 

DW src 
EndM 

CodeMacro Cmp dst : Aw, src : Dw 

DB 3DH 

DW src 
EndM 

CodeMacro Cmp dst : Eb,src: Rb 

Segfix dst 

DB 38H 

ModRM src, dst 
EndM 

CodeMacro Cmp dst : Ew, src : Rw 

Segfix dst 

DB 39H 

ModRM src, dst 
EndM 

CodeMacro Cmp dst : Rb,src : Eb 

Segfix src 

DB 3AH 

ModRM dst, src 
EndM 

CodeMacro Cmp dst : Rw, src : Ew 

Segfix src 

DB 3BH 

ModRM dst, src 
EndM 

CodeMacro CmpS SI_ptr : Mb,DI_ptr : Mb 

NoSegfix ES,DI_ptr 

Segfix SI_ptr 

DB 0A6H 
EndM 

CodeMacro CmpS SI_ptr : Mw,DI_ptr : Mw 

NoSegfix ES,DI_ptr 

Segfix SI_ptr 

DB 0A7H 
EndM 

CodeMacro CmpSB 

DB 0A6H 
EndM 

CodeMacro CmpSW 

DB 0A7H 
EndM 

CodeMacro CWD 

DB 99H 
EndM 

CodeMacro DAA 

DB 027H 
EndM 

CodeMacro DAS 

DB 02FH 
EndM 

CodeMacro Dec dst:Eb 

Segfix dst 

DB 0FEH 

ModRM l,dst 
EndM 



CodeMacro Dec dst:Ew 

Segfix dst 

DB 0FFH 

ModRM l,dst 
EndM 

CodeMacro Dec dst:Rw 

R53 <01001B,dst> 
EndM 

CodeMacro Div divisor:Eb 

Segfix divisor 

DB 0F6H 

ModRM 6, divisor 
EndM 

CodeMacro Div divisorrEw 

Segfix divisor 

DB 0F7H 

ModRM 6, divisor 
EndM 

; ENTER at end 

CodeMacro Esc opcode:Db (0 , 63) ,addr : Eb 

Segfix addr 

R53 <11011B, opcode. mid3> 

MouRM opcode, addr 
EndM 

CodeMacro Esc opcode :Db (0 , 63) , addr : Ew 

Segfix addr 

R53 <11011B, opcode. mid3> 

ModRM opcode, addr 
EndM 

CodeMacro Esc opcode : Db (0 , 63) , addr : Ed 
Segfix addr 

R53 <11011B, opcode. mid3> 
ModRM opcode, addr 

EndM 

CodeMacro Hit 

DB 0F4H 
EndM 

CodeMacro IDiv divisor:Eb 

Segfix divisor 

DB 0F6H 

ModRM 7, divisor 
EndM 

CodeMacro IDiv divisorrEw 

Segfix divisor 

DB 0F7H 

ModRM 7, divisor 
EndM 

CodeMacro Imul mplier:Eb 

Segfix mplier 

DB 0F6H 

ModRM 5, mplier 
EndM 

CodeMacro Imul mplier : Ew 

Segfix mplier 

DB 0F7H 

ModRM 5, mplier 
EndM 

CodeMacro IMUL dst: RW, srcl: EW, src2 :DB 

Onlyl86 

Segfix srcl 

DB 69H 

ModRM dst, srcl 

DW src2 
EndM 
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CodeMacro IMUL dst: RW, srcl: EW,src2 :DB (-128 , 127] 

Onlyl86 

Segfix srcl 

DB 6BH 

ModRM dst, srcl 

DB src2 
EndM 



CodeMacro Int itype:Db(3) 

DB 0CCH 
EndM 

CodeMacro Into 

DB 0CEH 
EndM 



CodeMacro IMUL dst: RW, srcl : EW,src2 :DW 

Onlyl86 

Segfix srcl 

DB 6 9H 

ModRM dst, srcl 

DW src2 
EndM 

CodeMacro IMUL dst : RW, src2 :DB 

Onlyl86 

DB 69H 

ModRM dst, dst 

DW src2 
EndM 

CodeMacro IMUL dst : RW, src2 : DB (-128 , 127) 

Onlyl86 

DB 6BH 

ModRM dst, dst 

DB src2 
EndM 

CodeMacro IMUL dst: RW, src2 :DW 

Onlyl86 

DB 6 9H 

ModRM dst, dst 

DW src2 
EndM 

CodeMacro In dst : Ab, port : Db 

DB 0E4H 

DB port 
EndM 

CodeMacro In dst : Aw, port :Db 

DB 0E5H 

DB port 
EndM 

CodeMacro In dst :Ab, port : Rw (DX) 

DB 0ECH 
EndM 

CodeMacro In dst : Aw, port : Rw (DX) 

DB 0EDH 
EndM 



CodeMacro Iret 

DB 0CFH 
EndM 

CodeMacro JA place:Cb 

DB 77H 

RelB place 
EndM 

CodeMacro JAE place:Cb 

DB 7 3H 

RelB place 
EndM 

CodeMacro JB place:Cb 

DB 7 2H 

RelB place 
EndM 

CodeMacro JBE place:Cb 

DB 76H 

RelB place 
EndM 

JC Equ JB 

CodeMacro JCXZ place:Cb 

DB 0E3H 

RelB place 
EndM 

CodeMacro JE place:Cb 

DB 7 4H 

RelB place 
EndM 

CodeMacro JG place:Cb 

DB 7FH 

RelB place 
EndM 

CodeMacro JGE place :Cb 

DB 7DH 

RelB place 
EndM 



CodeMacro Inc dst:Eb 

Segfix dst 

DB 0FEH 

ModRM 0,dst 
EndM 

CodeMacro Inc dst:Ew 

Segfix dst 

DB 0FFH 

ModRM 0,dst 
EndM 

CodeMacro Inc dst:Rw 

R53 <01000B,dst> 
EndM 

; INS,INSB,INSW at end 

CodeMacro Int itype:Db 

DB 0CDH 

DB itype 
EndM 



CodeMacro JL place:Cb 

DB 7CH 

RelB place 
EndM 

CodeMacro JLE place:Cb 

Db 7EH 

RelB place 
EndM 

CodeMacro Jmp place : Ew 

Segfix place 

DB 0FFH 

ModRM 4, place 
EndM 

CodeMacro Jmp place:Md 

Segfix place 

DB 0FFH 

ModRM 5, place 
EndM 
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CodeMacro Jrnp place:Cd 
DB 0EAH 
DD place 

EndM 

CodeMacro Jmp place:Cb 

DB 0EBH 

RelB place 
EndM 

CodeMacro Jmp place:Cw 

DB 0E9H 

RelW place 
EndM 

JNA Equ JBE 

JNAE Equ JB 

JNB Equ JAE 

JNBE Equ JA 

JNC Equ JNB 

CodeMacro JNE place:Cb 

DB 7 5H 

RelB place 
EndM 

JNG Equ JLE 
JNGE Equ JL 
JNL Equ JGE 
JNLE Equ JG 

CodeMacro JNO place:Cb 

DB 71H 

RelB place 
EndM 

CodeMacro JNP place:Cb 

DB 7BH 

RelB place 
EndM 

CodeMacro JNS place:Cb 

DB 79H 

RelB place 
EndM 

JNZ Equ JNE 

CodeMacro JO place:Cb 

DB 7 0H 

RelB place 
EndM 

CodeMacro JP place:Cb 

DB 7AH 

RelB place 
EndM 

JPE Equ JP 
JPO Equ JNP 

CodeMacro JS place:Cb 

DB 78H 

RelB place 
EndM 

JZ Equ JE 



CodeMacro LAHF 

DB 9FH 
EndM 

CodeMacro LDS dst : Rw, src : Ed 

Segfix src 

DB 0C5H 

ModRM dst, src 
EndM 

; LEAVE at end 

CodeMacro LES dst : Rw, src : Ed 

Segfix src 

DB 0C4H 

ModRM dst, src 
EndM 

CodeMacro LEA dst:Rw,src:M 

DB 8DH 

ModRM dst, src 
EndM 

CodeMacro Lock Prefx 

DB 0F0H 
EndM 

CodeMacro LodS SI_ptr:Mb 

Segfix SI_ptr 

DB 0ACH 
EndM 

CodeMacro LodS SI_ptr:Mw 

Segfix SI_ptr 

DB 0ADH 
EndM 

CodeMacro LodSB 

DB 0ACH 
EndM 

CodeMacro LodSW 

DB 0ADH 
EndM 

CodeMacro Loop place:Cb 

DB 0E2H 

RelB place 
EndM 

CodeMacro LoopE placerCb 

DB 0E1H 

RelB place 
EndM 

CodeMacro LoopNE place:Cb 

DB 0E0H 

RelB place 
EndM 

LoopNZ Equ LoopNE 

LoopZ Equ LoopE 

CodeMacro Mov dst : Eb ,src: Db 

Segfix dst 

DB 0C6H 

ModRM 0,dst 

DB src 
EndM 

CodeMacro Mov dst : Ew, src : Db 

Segfix dst 

DB 0C7H 

ModRM 0,dst 

DW src 
EndM 
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CodeMacro Mov dst : Ew, src :Dw 

S eg fix dst 

DB 0C7H 

ModRM 0,dst 

DW src 
EndM 

CodeMacro Mov dst : Rb,src : Db 

R53 <10110B,dst> 

DB src 
EndM 



CodeMacro Mov dst :Xb ,src: Ab 

Segfix dst 

DB 0A2H 

DW dst 
EndM 

CodeMacro Mov dst : Xw, src : Aw 

Segfix dst 

DB 0A3H 

DW dst 
EndM 



CodeMacro Mov dst : Rw, src :Db 

R53 <10111B,dst> 

DW src 
EndM 

CodeMacro Mov dst : Rw, src :Dw 

R53 <10111B,dst> 

DW src 
EndM 

CodeMacro Mov dst : Eb ,src : Rb 

Segfix dst 

DB 88H 

ModRM src, dst 
EndM 



CodeMacro MovS SI_ptr : Mb,DI_ptr : Mb 

NoSegfix ES,SI_ptr 

Segfix DI_ptr 

DB 0A4H 
EndM 

CodeMacro MovS SI_ptr : Mw,DI_ptr : Mw 

NoSegfix ES,SI_ptr 

Segfix DI_ptr 

DB 0A5H 
EndM 

CodeMacro MovSB 

DB 0A4H 
EndM 



CodeMacro Mov dst : Ew, src : Rw 

Segfix dst 

DB 89H 

ModRM src, dst 
EndM 

CodeMacro Mov dst : Rb, src : Eb 

Segfix src 

DB 8 AH 

ModRM dst, src 
EndM 

CodeMacro Mov dst : Rw, src : Ew 

Segfix src 

DB 8BH 

ModRM dst, src 
EndM 

CodeMacro Mov dst:Ew,src:S 

Segfix dst 

DB 08CH 

ModRM src, dst 
EndM 

CodeMacro Mov dst : S (ES) ,src: Ew 

Segfix src 

DB 08EH 

ModRM dst, src 
EndM 

CodeMacro Mov dst : S (SS , DS) ,src : Ew 

Segfix src 

DB 08EH 

ModRM dst, src 
EndM 



CodeMacro MovSW 

DB 0A5H 
EndM 

CodeMacro Mul mplier:Eb 

Segfix mplier 

DB 0F6H 

ModRM 4, mplier 
EndM 

CodeMacro Mul mplier : Ew 

Segfix mplier 

DB 0F7H 

ModRM 4, mplier 
EndM 

CodeMacro Neg dst:Eb 

Segfix dst 

DB 0F6H 

ModRM 3, dst 
EndM 

CodeMacro Neg dst:Ew 

Segfix dst 

DB 0F7H 

ModRM 3, dst 
EndM 

CodeMacro Nil 
EndM 

CodeMacro Nop 

DB 9 0H 
EndM 



CodeMacro Mov dst : Ab ,src : Xb 

Segfix src 

DB' 0A0H 

DW src 
EndM 



CodeMacro Not dst:Eb 

Segfix dst 

DB 0F6H 

ModRM 2, dst 
EndM 



CodeMacro Mov dst : Aw, src : Xw 

Segfix src 

DB 0A1H 

DW src 
EndM 



CodeMacro Not dst:Ew 

Segfix dst 

DB 0F7H 

ModRM 2, dst 
EndM 
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CodeMacro OR dst : Eb, src: Db 

Segfix dst 

DB 8 0H 

ModRM l,dst 

DB src 
EndM 

CodeMacro OR dst: Ew,src:Dw 

Segfix dst 

DB 81H 

ModRM l,dst 

DW src 
EndM 

CodeMacro OR dst: Ew, src: Db 

Segfix dst 

DB 81H 

ModRM l,dst 

DW src 
EndM 

CodeMacro OR dst : Ab ,src : Db 

DB 0CH 

DB src 
EndM 

CodeMacro OR dst: Aw, src : Db 

DB 0DH 

DW src 
EndM 

CodeMacro OR dst: Aw, src: Dw 

DB 0DH 

DW src 
EndM 

CodeMacro OR dst : Eb,src : Rb 

Segfix dst 

DB 8 

ModRM src, dst 
EndM 

CodeMacro OR dst : Ew, src : Rw 

Segfix dst 

DB 9 

ModRM src, dst 
EndM 

CodeMacro OR dst : Rb,src: Eb 

Segfix src 

DB 0AH 

ModRM dst, src 
EndM 

CodeMacro OR dst : Rw, src : Ew 

Segfix src 

DB 0BH 

ModRM dst, src 
EndM 

CodeMacro Out port :Db , dst : Ab 

DB 0E6H 

DB port 
EndM 

CodeMacro Out port :Db,dst : Aw 

DB 0E7H 

DB port 
EndM 

CodeMacro Out port : Rw (DX) , dst :Ab 

DB 0EEH 
EndM 

CodeMacro Out port : Rw (DX) ,dst : Aw 

DB 0EFH 
EndM 



; OUTS,OUTSB,OUTSW at end 

CodeMacro Pop dst:Ew 

Segfix dst 

DB 08FH 

ModRM 0,dst 
EndM 

CodeMacro Pop dst:S(ES) 

R323 <0,dst,7> 
EndM 

CodeMacro Pop dst:S(SS,DS) 
R323 <0,dst,7> 

EndM 

CodeMacro Pop dst:Rw 

R53 <01011B,dst> 
EndM 

; POPA at end 



CodeMacro PopF 

DB 9DH 
EndM 

CodeMacro PUSH src:D 

Onlyl86 

DB 68H 

DW src 
EndM 



CodeMacro PUSH src : DB (-128 , 127) 
Onlyl86 
DB 6 AH 
DB src 

EndM 



CodeMacro Push src : Ew 

Segfix src 

DB 0FFH 

ModRM 6, src 
EndM 



CodeMacro Push src:S 
R323 <0,src,6> 

EndM 



CodeMacro Push src:Rw 

R53 <01010B,src> 
EndM 

; PUSHA moved to end 

CodeMacro PushF 

DB 9CH 
EndM 

CodeMacro RCL dst: Eb , count :D (0, 31] 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 2, dst 

DB count 
EndM 

CodeMacro RCL dst : Eb , count :Db (1) 

Segfix dst 

DB 0D0H 

ModRM 2, dst 
EndM 
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CodeMacro RCL dst: Ew, count : D (0, 31) 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 2, dst 

DB count 
EndM 

CodeMacro RCL dst : Ew, count : Db (1) 

Segfix dst 

DB 0D1H 

ModRM 2, dst 
EndM 

CodeMacro RCL dst : Eb, count : Rb (CL) 

Segfix dst 

DB 0D2H 

ModRM 2, dst 
EndM 

CodeMacro RCL dst : Ew , count : Rb (CL) 

Segfix dst 

DB 0D3H 

ModRM 2, dst 
EndM 

CodeMacro RCR dst: Eb, count :D (0, 31) 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 3, dst 

DB count 
EndM 

CodeMacro RCR dst : Eb , count : Db ( 1) 

Segfix dst 

DB 0D0H 

ModRM 3, dst 
EndM 

CodeMacro RCR dst : EW, count : D (0 , 31) 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 3, dst 

DB count 
EndM 

CodeMacro RCR dst : Ew , count : Db (1) 

Segfix dst 

DB 0D1H 

ModRM 3, dst 
EndM 

CodeMacro RCR dst : Eb, count : Rb (CL) 

Segfix dst 

DB 0D2H 

ModRM 3, dst 
EndM 

CodeMacro RCR dst : Ew, count : Rb (CL) 

Segfix dst 

DB 0D3H 

ModRM 3, dst 
EndM 

CodeMacro Rep Prefx 

DB 0F3H 
EndM 

CodeMacro RepE Prefx 

DB 0F3H 
EndM 



CodeMacro RepNE Prefx 

DB 0F2H 
EndM 



RepNZ Equ RepNE 
RepZ Equ RepE 

CodeMacro Ret src:Db 

R413 <0CH,Proclen,2> 

DW src 
EndM 

CodeMacro Ret src:Dw 

R413 <0CH,Proclen, 2> 

DW src 
EndM 

CodeMacro Ret 

R413 <0CH,Proclen,3> 
EndM 

CodeMacro ROL dst : Eb, count :D (0, 31) 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 0,dst 

DB count 
EndM 

CodeMacro ROL dst : Eb, count : Db ( 1) 

Segfix dst 

DB 0D0H 

ModRM 0,dst 
EndM 

CodeMacro ROL dst : Ew , count :D ( 0, 31) 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 0,dst 

DB count 
EndM 

CodeMacro ROL dst : Ew, count :Db ( 1) 

Segfix dst 

DB 0D1H 

ModRM 0,dst 
EndM 

CodeMacro ROL dst : Eb , count : Rb (CL) 

Segfix dst 

DB 0D2H 

ModRM 0,dst 
EndM 

CodeMacro ROL dst: Ew , count : Rb (CL) 

Segfix dst 

DB 0D3H 

ModRM 0,dst 
EndM 

CodeMacro ROR dst : Eb, count :D ( 0, 31) 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM l,dst 

DB count 
EndM 

CodeMacro ROR dst: Eb, count :Db (1) 

Segfix dst 

DB 0D0H 

ModRM l,dst 
EndM 
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CodeMacro ROR dst: 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM l,dst 

DB count 
EndM 

CodeMacro ROR dst: 
Segfix dst 
DB 0D1H 
ModRM l,dst 

EndM 

CodeMacro ROR dst: 
Segfix dst 
DB 0D2H 
ModRM l,dst 

EndM 

CodeMacro ROR dst: 
Segfix dst 
DB 0D3H 
ModRM l,dst 

EndM 

CodeMacro SAHF 

DB 9EH 
EndM 

CodeMacro SAL dst: 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 4, dst 

DB count 
EndM 

CodeMacro SAL dst: 
Segfix dst 
DB 0D0H 
ModRM 4, dst 

EndM 

CodeMacro SAL dst: 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 4, dst 

DB count 
EndM 

CodeMacro SAL dst: 
Segfix dst 
DB 0D1H 
ModRM 4, dst 

EndM 

CodeMacro SAL dst: 
Segfix dst 
DB 0D2H 
ModRM 4, dst 

EndM 

CodeMacro SAL dst: 
Segfix dst 
DB 0D3H 
ModRM 4, dst 

EndM 

CodeMacro SAR dst: 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 7, dst 

DB count 
EndM 



Ew,count:D (0, 31) 



Ew,count:Db (1) 



Eb, count: Rb (CL) 



Ew, count: Rb (CL) 



Eb,count:D(0,31) 



Eb, count :Db (1) 



;Ew,count:D (0,31) 



Ew, count : Db (i; 



Eb,count:Rb (CL) 



: Ew, count : Rb (CL) 



Eb,count:D(0,31) 



CodeMacro SAR dst : Eb, count :Db ( 1) 

Segfix dst 

DB 0D0H 

ModRM 7, dst 
EndM 

CodeMacro SAR dst : Ew , count :D (0, 31) 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 7, dst 

DB count 
EndM 

CodeMacro SAR dst : Ew, count : Db ( 1) 

Segfix dst 

DB 0D1H 

ModRM 7, dst 
EndM 

CodeMacro SAR dst : Eb , count : Rb (CL) 

Segfix dst 

DB 0D2H 

ModRM 7, dst 
EndM 

CodeMacro SAR dst : Ew , count : Rb (CL) 

Segfix dst 

DB 0D3H 

ModRM 7, dst 
EndM 

CodeMacro Sbb dst : Eb,src: Db 

Segfix dst 

DB 8 0H 

ModRM 3, dst 

DB src 
EndM 

CodeMacro Sbb dst : Ew, src :Db 

Segfix dst 

DB 81H 

ModRM 3, dst 

DW src 
EndM 

CodeMacro Sbb dst : Ew, src : Db (-128 , 127] 

Segfix dst 

DB 8 3H 

ModRM 3, dst 

DB src 
EndM 

CodeMacro Sbb dst : Ew, src : Dw 

Segfix dst 

DB 81H 

ModRM 3, dst 

DW src 
EndM 

CodeMacro Sbb dst : Ab ,src :Db 

DB 1CH 

DB src 
EndM 

CodeMacro Sbb dst : Aw, src : Db 

DB 1DH 

DW src 
EndM 

CodeMacro Sbb dst : Aw, src : Dw 

DB 1DH 

DW src 
EndM 
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CodeMacro Sbb dst : Eb, src : Rb 

Segfix dst 

DB 18H 

ModRM src, dst 
EndM 

CodeMacro Sbb dst : Ew, src : Rw 

Segfix dst 

DB 19H 

ModRM src, dst 
EndM 

CodeMacro Sbb dst : Rb,src : Eb 

Segfix src 

DB 1AH 

ModRM dst, src 
EndM 

CodeMacro Sbb dst : Rw, src : Ew 

Segfix src 

DB 1BH 

ModRM dst, src 
EndM 

CodeMacro ScaS DI_ptr:Mb 

NoSegfix ES,DI_ptr 

DB 0AEH 
EndM 



CodeMacro SHR dst : Ew , count : Rb (CL) 

Segfix dst 

DB 0.D3H 

ModRM 5, dst 
EndM 

CodeMacro STC 

DB 0F9H 
EndM 

CodeMacro STD 

DB 0FDH 
EndM 

CodeMacro STI 

DB 0FBH 
EndM 

CodeMacro StoS DI_ptr:Mb 

NoSegfix ES,DI_ptr 

DB 0AAH 
EndM 

CodeMacro StoS DI_ptr:Mw 

NoSegfix ES,DI_ptr 

DB 0ABH 
EndM 



CodeMacro ScaS DI_ptr:Mw 

NoSegfix ES,DI_ptr 

DB 0AFH 
EndM 

CodeMacro ScaSB 

DB 0AEH 
EndM 

CodeMacro ScaSW 

DB 0AFH 
EndM 

SHL Equ SAL 

CodeMacro SHR dst : Eb, count :D ( 0, 31) 

Onlyl86 

Segfix dst 

DB 0C0H 

ModRM 5, dst 

DB count 
EndM 

CodeMacro SHR dst: Eb, count :Db ( 1) 

Segfix dst 

DB 0D0H 

ModRM 5, dst 
EndM 

CodeMacro SHR dst : Ew , count : D ( 0, 31) 

Onlyl86 

Segfix dst 

DB 0C1H 

ModRM 5, dst 

DB count 
EndM 

CodeMacro SHR dst : Ew , count : Db ( 1) 

Segfix dst 

DB 0D1H 

ModRM 5, dst 
EndM 

CodeMacro SHR dst : Eb, count : Rb (CL) 

Segfix dst 

DB 0D2H 

ModRM 5, dst 
EndM 



CodeMacro StoSB 

DB 0AAH 
EndM 

CodeMacro StoSW 

DB 0ABH 
EndM 

CodeMacro Sub dst : Eb,src : Db 

Segfix dst 

DB 8 0H 

ModRM 5, dst 

DB src 
EndM 

CodeMacro Sub dst : Ew, src :Db 

Segfix dst 

DB 81H 

ModRM 5, dst 

DW src 
EndM 

CodeMacro Sub dst : Ew, src :Db (-128 , 127; 

Segfix dst 

DB 8 3H 

ModRM 5, dst 

DB src 
EndM 

CodeMacro Sub dst : Ew, src : Dw 

S eg f i x dst 

DB 81H 

ModRM 5, dst 

DW src 
EndM 

CodeMacro Sub dst : Ab,src:Db 

DB 2CH 

DB src 
EndM 

CodeMacro Sub dst : Aw, src :Db 

DB 2DH 

DW src 
EndM 
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CodeMacro Sub dst : Aw, src :Dw 

DB 2DH 

DW src 
EndM 

CodeMacro Sub dst :.Eb,src: Rb 

Segfix dst 

DB 28H 

ModRM src, dst 
EndM 

CodeMacro Sub dst : Ew, src : Rw 

Segfix dst 

DB 29H 

ModRM src, dst 
EndM 

CodeMacro Sub dst : Rb ,src : Eb 

Segfix src 

DB 2 AH 

ModRM dst, src 
EndM 

CodeMacro Sub dst : Rw, src : Ew 

Segfix src 

DB 2BH 

ModRM dst, src 
EndM 

CodeMacro Test dst : Eb,src :Db 

Segfix dst 

DB 0F6H 

ModRM 0,dst 

DB src 
EndM 

CodeMacro Test dst: Ew, src:Db 

Segfix dst 

DB 0F7H 

ModRM 0,dst 

DW src 
EndM 

CodeMacro Test dst : Ew, src :Dw 

Segfix dst 

DB 0F7H 

ModRM 0,dst 

DW src 
EndM 

CodeMacro Test dst: Ab,src :Db 

DB 0A8H 

DB src 
EndM 

CodeMacro Test dst : Aw, src :Db 

DB 0A9H 

DW src 
EndM 

CodeMacro Test dst : Aw, src : Dw 

DB 0A9H 

DW src 
EndM 

CodeMacro Test dst: Eb ,src : Rb 

Segfix dst 

DB 8 4H 

ModRM src, dst 
EndM 

CodeMacro Test dst : Ew, src : Rw 

Segfix dst 

DB 8 5H 

ModRM srcr,dst 
EndM 



CodeMacro Test dst : Rb,src: Eb 

Segfix src 

DB 8 4H 

ModRM dst, src 
EndM 

CodeMacro Test dst: Rw, src : Ew 

Segfix src 

DB 8 5H 

ModRM dst, src 
EndM 

CodeMacro Wait 

DB 09BH 
EndM 

CodeMacro Xchg dst : Eb,src : Rb 

Segfix dst 

DB 86H 

ModRM src, dst 
EndM 

CodeMacro Xchg dst : Ew, src : Rw 

Segfix dst 

DB 87H 

ModRM src, dst 
EndM 

CodeMacro Xchg dst : Rb,src : Eb 

Segfix src 

DB 86H 

ModRM dst, src 
EndM 

CodeMacro Xchg dst : Rw, src : Ew 

Segfix src 

DB 87H 

ModRM dst, src 
EndM 

CodeMacro Xchg dst : Rw,src: Aw 

R53 <10010B,dst> 
EndM 

CodeMacro Xchg dst : Aw, src: Rw 

R53 <10010B,src> 
EndM 

CodeMacro Xlat table:Mb 

Segfix table 

DB 0D7H 
EndM 

CodeMacro XlatB 

DB 0D7H 
EndM 

CodeMacro Xor dst : Eb,src : Db 

Segfix dst 

DB 8 0H 

ModRM 6, dst 

DB src 
EndM 

CodeMacro Xor dst : Ew, src :Db 

Segfix dst 

DB 81H 

ModRM 6, dst 

DW src 
EndM 

CodeMacro Xor dst :Ew,src:Dw 

Segfix dst 

DB 81H 

ModRM 6, dst 

DW src 
EndM 
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CodeMacro Xor dst : Ab,src : Db 

DB 3 4H 

DB src 
EndM 



CodeMacro FADDP dst:F,src:T 
Rfix 110B 
R233 <HB,000B,dst> 

EndM 



CodeMacro Xor dst : Aw, src: Db 

DB 3 5H 

DW src 
EndM 



CodeMacro FBLD memop:Mt 
RfixM lllB,memop 
ModRM 100B,memop 

EndM 



CodeMacro Xor dst : Aw, src:Dw 

DB 3 5H 

DW src 
EndM 



CodeMacro FBSTP meroop:Mt 
RfixM lllB,memop 
ModRM 110B,memop 

EndM 



CodeMacro Xor dst : Eb,src : Rb 

Segfix dst 

DB 3 0H 

ModRM src, dst 
EndM 

CodeMacro Xor dst : Ew, src: Rw 

Segfix dst 

DB 31H 

ModRM src, dst 
EndM 

CodeMacro Xor dst : Rb,src : Eb 

Segfix src 

DB 3 2H 

ModRM dst, src 
EndM 

CodeMacro Xor dst: Rw,src: Ew 

Segfix src 

DB 3 3H 

ModRM dst, src 
EndM 



CodeMacro FCHS 

Rfix 001B 

DB 11100000B 
EndM 

CodeMacro FCLEX 

Rfix 011B 

DB 11100010B 
EndM 

CodeMacro FCOM memop:Md 
RfixM 000B,memop 
ModRM 010B,memop 

EndM 

CodeMacro FCOM memop:Mq 
RfixM 100B,memop 
ModRM 010B,memop 

EndM 

CodeMacro FCOM fpsf.F 

Rfix 000B 

R233 <HB,010B,fpst> 
EndM 



; 8087 Codemacros: 

CodeMacro F2XM1 

Rfix 001B 

DB 11110000B 
EndM 

CodeMacro FABS 

Rfix 001B 

DB 11100001B 
EndM 

CodeMacro FADD memop:Md 

RfixM 000B,memop 

ModRM 000B,memop 
EndM 

CodeMacro FADD memop:Mq 

RfixM 100B,memop 

ModRM 000B,memop 
EndM 

CodeMacro FADD dst:T,src:F 

Rfix 000B 

R233 <HB,000B,src> 
EndM 

CodeMacro FADD dst:F,src:T 

Rfix 100B 

R233 <HB,000B,dst> 
EndM 



CodeMacro FCOM 

Rfix 000B 

DB 11010001B 
EndM 

CodeMacro FCOMP memop:Md 
RfixM 000B,memop 
ModRM 01lB,memop 

EndM 

CodeMacro FCOMP memop:Mq 
RfixM 100B,memop 
ModRM 01lB,memop 

EndM 

CodeMacro FCOMP fpst:F 

Rfix 000B 

R233 <HB,011B,fpst> 
EndM 

CodeMacro FCOMP 

Rfix 000B 

DB 11011001B 
EndM 

CodeMacro FCOMPP 

Rfix 110B 

DB 11011001B 
EndM 



CodeMacro FADD 
Rfix 110B 
DB 11000001B 

EndM 



CodeMacro FDECSTP 
Rfix 001B 
DB 11110110B 

EndM 
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CodeMacro FDISI 

Rfix 01 IB 

DB 11100001B 
EndM 

CodeMacro FDIV memop:Md 

RfixM 000B, memop 

ModRM 110B,memop 
EndM 

CodeMacro FDIV memop:Mq 

RfixM 100B,memop 

ModRM 110B,memop 
EndM 

CodeMacro FDIV dst:T,src:F 

Rfix 000B 

R233 <HB,110B,src> 
EndM 



CodeMacro FIADD memop:Mw 
RfixM 110B, memop 
ModRM 000B,memop 

EndM 

CodeMacro FIADD memop:Md 
RfixM 010B,memop 
ModRM 000B, memop 

EndM 

CodeMacro FICOM memoprMw 
RfixM 110B, memop 
ModRM 010B,memop 

EndM 

CodeMacro FICOM memoprMd 

RfixM 010B,memop 

ModRM 010B,memop 
EndM 



CodeMacro FDIV dst:F,src:T 

Rfix 100B 

R233 <HB,lllB,dst> 
EndM 



CodeMacro FICOMP memoprMw 

RfixM 110B,memop 

ModRM 011B,memop 
EndM 



CodeMacro FDIV 
Rfix 110B 
DB 11111001B 

EndM 



CodeMacro FICOMP memoprMd 

RfixM 010B,memop 

ModRM 011B, memop 
EndM 



CodeMacro FDIVP dst:F,src:T 

Rfix 110B 

R233 <llB,lllB,dst> 
EndM 



CodeMacro FIDIV memop:Mw 
RfixM 110B,memop 
ModRM 110B,memop 

EndM 



CodeMacro FDIVR memop:Md 
RfixM 000B, memop 
ModRM lllB,memop 

EndM 



CodeMacro FIDIV memoprMd 
RfixM 010B,memop 
ModRM 110B,memop 

EndM 



CodeMacro FDIVR memop:Mq 
RfixM 100B,memop 
ModRM lllB,memop 

EndM 



CodeMacro FIDIVR memoprMw 

RfixM 110B,memop 

ModRM lllB,memop 
EndM 



CodeMacro FDIVR dstrT,srcrF 

Rfix 000B 

R233 <HB,lllB,src> 
EndM 



CodeMacro FIDIVR memoprMd 

RfixM 010B, memop 

ModRM lllB,memop 
EndM 



CodeMacro FDIVR dstrF,srcrT 

Rfix 100B 

R233 <HB,110B,dst> 
EndM 



CodeMacro FILD memoprMw 
RfixM 111B, memop 
ModRM 000B,memop 

EndM 



CodeMacro FDIVR 
Rfix 110B 
DB 11110001B 

EndM 



CodeMacro FILD memop: 
RfixM 011B, memop 
ModRM 000B, memop 

EndM 



Md 



CodeMacro FDIVRP dstrF,srcrT 

Rfix 110B 

R233 <llB,110B,dst> 
EndM 



CodeMacro FILD memoprMq 
RfixM 111B, memop 
ModRM 101B, memop 

EndM 



CodeMacro FEN I 
Rfix 011B 
DB 11100000B 

EndM 



CodeMacro FIMUL memoprMw 
RfixM 110B, memop 
ModRM 001B, memop 

EndM 



CodeMacro FFREE fpstrF 

Rfix 101B 

R233 <HB,000B,fpst> 
EndM 



CodeMacro FIMUL memoprMd 
RfixM 010B, memop 
ModRM 001B, memop 

EndM 
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CodeMacro FINCSTP 

Rfix 001B 

DB 11110111B 
EndM 

CodeMacro FINIT 

Rfix 011B 

DB 11100011B 
EndM 

CodeMacro FIST memop:Mw 

RfixM lllB,memop 

ModRM 010B,memop 
EndM 

CodeMacro FIST memop:Md 

RfixM 011B,memop 

ModRM 010B,memop 
EndM 

CodeMacro FISTP memop:Mw 

RfixM lllB,memop 

ModRM 011B,memop 
EndM 

CodeMacro FISTP memop:Md 

RfixM 011B,memop 

ModRM 011B„memop 
EndM 

CodeMacro FISTP memop:Mq 

RfixM lllB,memop 

ModRM lllB,memop 
EndM 

CodeMacro FISUB memop:Mw 

RfixM 110B,memop 

ModRM 100B,memop 
EndM 

CodeMacro FISUB memop:Md 

RfixM 010B,memop 

ModRM 100B,memop 
EndM 

CodeMacro FISUBR memop:Mw 

RfixM 110B,memop 

ModRM 101B,memop 
EndM 

CodeMacro FISUBR memop:Md 

RfixM 010B,memop 

ModRM 101B,memop 
EndM 

CodeMacro FLD memop:Md 

RfixM 001B,memop 

ModRM 000B,memop 
EndM 

CodeMacro FLD memop:Mq 

RfixM 101B,memop 

ModRM 000B,memop 
EndM 

CodeMacro FLD memop:Mt 
RfixM 011B,memop 
ModRM 101B,memop 

EndM 

CodeMacro FLD fpst:F 
Rfix 001B 
R233 <HB,000B,fpst> 

CodeMacro FISTP memoprMw 

RfixM 111B, memop 

ModRM 01lB,memop 
EndM 



CodeMacro FISTP mennon:Md 
RfixM 01lB,memop 
ModRM 01lB,memop 

EndM 

CodeMacro FISTP memoo:Mq 
RfixM lllB,memop 
ModRM lllB,memoo 

EndM 

CodeMacro FISUB memoorMw 
RfixM 110B,memop 
ModRM 100B,meniop 

EndM 

CodeMacro FISUB memooiMd 
RfixM 010B,memop 
ModRM 100B,memop 

EndM 



CodeMacro FISUBR memoprMw 

RfixM 110B,metnop 

ModRM 10lB,memoD 
EndM 

CodeMacro FISUBR Tiemop:Md 

RfixM 010B,memoD 

ModRM 10lB7niemoD 
EndM 

CodeMacro FLD memop:Md 

RfixM 00lB,memop 

ModRM 000B".meniop 
EndM 

CodeMacro FLD memoprMq 

RfixM 10lB',niemop 

ModRM 000B ,'memop 
EndM 

CodeMacro FLD memop:Mt 

RfixM 01lB,rnemon 

ModRM 101B .mernop 
EndM 

CodeMacro FLD fpst:F 

Rfix 001B 

R233 <11B. 000B,fpst> 
EndM 

CodeMacro FLD1 

Rfix 001B 

DB 11101000B 
EndM 

CodeMacro FLDCW memoprM 

RfixM 00lB f meTnoD 

ModRM 10lB,'nneTTiop 
EndM 

CodeMacro FLDENV memoprM 

RfixM 00lB,memoo 

ModRM 100B r memop 
EndM 

CodeMacro FLDL2E 

Rfix 001B 

DB 11101010B 
EndM 

CodeMacro FLDL2T 

Rfix 001B 

DB 11101001B 
EndM 
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CodeMacro FLDLG2 
Rfix 001B 
DB 11101100B 

EndM 



CodeMacro FNSAVE memoprM 
RNfixM 10lB,mewioD 
MOdRM 110B.'memop 

EndM 



CodeMacro FLDLN2 
Rfix 001B 
DB 11101101B 

EndM 



CodeMacro FNSTCW memoprM 
RNfixM 00lB'.'"iemoD 
ModRM lllB.'nieTTiop 

EndM 



CodeMacro FLDPI 
Rfix 001B 
DB 11101011B 

EndM 



CodeMacro FNSTENV tiemoorM 
RNfixM 00lB,memop 
ModRM 110B,memop 

EndM 



CodeMacro FLDZ 
Rfix 001B 
DB 11101110B 

EndM 



CodeMacro FNSTSW memoprM 
RNfixM 10lB,memoo 
ModRM HlB".'nieTTioD 

EndM 



CodeMacro FMUL memoprMd 
RfixM 000B,memon 
ModRM 00lB".'merriop 

EndM 



CodeMacro FPATAN 
Rfix 001B 
DB 11110011B 

EndM 



CodeMacro FMUL memop:Mq 
RfixM 100B".mefnoo 
ModRM 001B .'memop 

EndM 



CodeMacro FPREM 
Rfix 001B 
DB 11111000B 

EndM 



CodeMacro FMUL dst:T,src:F 

Rfix 000B 

R233 <llB.'00lB,src> 
EndM 



CodpMacro FPTAN 
Rfix 001B 
DB 1111001 0B 

EndM 



CodeMacro FMUL dst:F.<?rc:T 

Rfix 100B 

R233 <HB,00lB,dst> 
EndM 



CodeMacro FRNDINT 
Rfix 001B 
DB 11111100B 

EndM 



CodeMacro FMUL 
Rfix 110B 
DB 11001001B 

EndM 



CodeMacro FRSTOR ienioD:M 
RfixM 10lB,memop 
ModRM 100B,memoD 

EndM 



CodeMacro FMULP dst:F".«?rc:T 

Rfix 110B 

R233 <HB,00lB,dst> 
EndM 



CodeMacro FSAVE inemop:M 
RfixM 10lB,memoD 
ModRM 110B".'me"iOD 

EndM 



CodeMacro FNCLEX 
RNfix 011B 
DB 11100010B 

EndM 



CodeMacro FSCALE 
Rfix 001B 
DB 11111101R 

EndM 



CodeMacro FNDISI 
RNfix 011B 
DB 11100001B 

EndM 



CodeMacro FSQRT 
Rfix 001B 
DB 11111010B 

EndM 



CodeMacro FNENI 
RNfix 011B 
DB 11100000B 

EndM 



CodeMacro FST niemop:Md 
RfixM 00lB,meniop 
ModRM 010B,memop 

EndM 



CodeMacro FNINIT 
RNfix 011B 
DB 11100011B 

EndM 



CodeMacro FST memoorMq 
RfixM 10lB,'memop 
ModRM 010B,memop 

EndM 



CodeMacro FNOP 
Rfix 001B 
DB 11010000B 

EndM 



CodeMacro FST fost:F 

Rfix 101B 

R233 <HB,010B',fost> 
EndM 
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CodeMacro FSTCW raemoDiM 
RfixM 00lB,memop 
ModRM 111B .ne^ioo 

EndM 



CodeMacro FSUBR dst:T'."src:F 

Rfix 000B 

R233 <11B, 10lB,src> 
EndM 



CodeMacro FSTENV memoprM 
RfixM 00lB,memoo 
ModRM 110B ."TiemoD 

EndM 

CodeMacro FSTP memop:Md 
RfixM 00lBVimemoD 
ModRM 01lB,memop 

EndM 

CodeMacro FSTP memop:Mq 
RfixM 10lB"."menioo 
ModRM 011B.'memop 

EndM 

CodeMacro FSTP memonrMt 
RfixM 01lB.'memop 
ModRM lllB,memop 

EndM 

CodeMacro FSTP f ost :F 

Rfix 101B 

R233 <HB,01lB,fpst> 
EndM 



CodeMacro FSUBR dst :F'.'src :T 

Rfix 100B 

R233 <llB,100B,dst> 
EndM 

CodeMacro FSUBR 

Rfix 110B 

DB 11100001B 
EndM 

CodeMacro FSUBRP dst :F .'src :T 

Rfix 110B 

R233 <11B, 100B,dst> 
EndM 

CodeMacro FTST 

Rfix 001B 

DB 11100100B 
EndM 

CodeMacro FWAIT 

RWfix 
EndM 



CodeMacro FSTSW mernoprM 
RfixM 10lB,memop 
ModRM lllB,memoo 

EndM 



CodeMacro FXAM 
Rfix 001B 
DB 11100101B 

EndM 



CodeMacro FSUB meTioorMd 
RfixM 000B,memop 
ModRM 100B>e^oo 

EndM 

CodeMacro FSUB memop:Mq 
RfixM 100B,memop 
ModRM 100B',nieTnoo 

EndM 



CodeMacro FXCH fost:F 

Rfix 001B 

R233 <HB,001B,fpst> 
EndM 

CodeMacro FXCH 

Rfix 001B 

DB 11001001B 
EndM 



CodeMacro FSUB dst:T,src:F 

Rfix 000B 

R233 <11B', 100B.'src> 
EndM 

CodeMacro FSUB dst:F,src:T 

Rfix 100B 

R233 <11B"; 10lB.'dst> 
EndM 

CodeMacro FSUB 

Rfix 110B 

DB 11101001B 
EndM 

CodeMacro FSUBP dst:F,src:T 

Rfix 110B 

R233 <HB.10lB.'dst> 
EndM 

CodeMacro FSUBR memoprMd 

RfixM 000B,meinon 

ModRM 10lB,memop 
EndM 

CodeMacro FSUBR memoprMq 

RfixM 100B .nieTiop 

ModRM 10lB.memop 
EndM 



CodeMacro FXTRACT 

Rfix 001B 

DB 11110100B 
EndM 

CodeMacro FYL2X 

Rfix 001B 

DB 11110001B 
EndM 

CodeMacro FYL2XP1 

Rfix 001B 

DB 11111001B 
EndM 

CodeMacro BOUND indx : RW, bptr :MW 

Onlyl86 

Segfix botr 

DB 62H 

ModRM indx -botr 
EndM 

CodeMacro BOUND indx : RW'.bntr :MD 

Only 18 6 

Segfix bptr 

DB 62H 

ModRM indx',botr 
EndM 



A-33 



Codemacros ASM86 



CodeMacro ENTER di sp : D (0 .' 0FFFFH) .'level : D (0 .' 255 ) CodeMacro OUTS port: RW (DX) .'si ptr:EW 

Onlyl86 Onlyl86 

DB 0C8H Segfix si_ptr 

DW diso DB 6FH 

DB Ifvel EndM 
EndM 

CodeMacro OUTSB 

CodeMacro INS di_ptr : EB ,port : RW (DX) Onlyl86 

Onlyl86 DB 6EH 

NoSeqfix ES'.di otr EndM 

DB 6CH 

EndM CodeMacro OUTSW 

Onlyl86 

CodeMacro INS di_ptr : EW,port : RW (DX) DB 6FH 

Onlvl86 EndM 

NoSeqfix ES.'di ptr 

DB 6DH CodeMacro POPA 

EndM Onlvl86 

DB 61H 

CodeMacro INSB EndM 

Onlyl86 

DB 6CH CodeMacro PUSHA 

EndM Onlyl86 

DB 60H 

CodeMacro INSW EndM 

Onlyl86 

DB 6DH Purqe R53 . R32 3 . R233 . R413 

EndM Purge RF1, RF2 , RF3 , RF4 . RF5 

Purqe RF6.RF7,RF8,RF9 

CodeMacro LEAVE Purqe RF10,Mid3 

Onlvl86 

DB 0C9H END 
EndM 

CodeMacro OUTS port : RW (DX) ,si_ptr : EB 

Onlyl86 

Seqfix si otr 

DB 6EH 
EndM 
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FLAG REGISTERS 

Flags are used to distinguish or denote certain results of data manipulation. The 
8086 provides the four basic mathematical operations (+, -,*,/) in a number of 
different varieties. Both 8- and 16-bit operations and both signed and unsigned 
arithmetic are provided. Standard two's complement representation of signed 
values is used. The addition and subtraction operations serve as both signed and 
unsigned operations. In these cases the flag settings allow the distinction between 
signed and unsigned operations to be made (see Conditional Transfer instructions in 
Chapter 6). 

Adjustment operations are provided to allow arithmetic to be performed directly on 
unpacked decimal digits or on packed decimal representations, and the auxiliary flag 
(AF) facilitates these adjustments. 

Flags also aid in interpreting certain operations which could destroy one of their 
operands. For example, a compare is actually a subtract operation; a zero result in- 
dicates that the operands are equal. Since it is unacceptable for the compare to 
destroy either of the operands, the processor includes several work registers reserved 
for its own use in such operations. The programmer cannot access these registers. 
They are used for internal data transfers and for holding temporary values in 
destructive operations, whose results are reflected in the flags. 

Your program can test the setting of five of these flags (carry, sign, zero, overflow, 
and parity) using one of the conditional jump instructions. This allows you to alter 
the flow of program execution based on the outcome of a previous operation, the 
auxiliary carry flag is reserved for the use of the ASCII and decimal adjust instruc- 
tions, as will be explained later in this section. 

It is important for you to know which flags are set by a particular instruction. 
Assume, for example, that your program is to test the parity of an input byte and 
then execute one instruction sequence if parity is even, a different instruction se- 
quence if parity is odd. Coding a JPE (jump if parity is even) or JPO (jump if parity 
is odd) instruction immediately following the IN (input) instruction would produce 
false results, since the IN instruction does not affect the condition flags. The jump 
conditionally executed by your program would reflect the outcome of some previous 
operation unrelated to the IN instructions. 

For the operation to work correctly, you must include some instruction that alters 
the parity flag after the IN instruction, but before the jump instruction. For exam- 
ple, you can add zero to the input byte in the accumulator. This sets the parity flag 
without altering the data in the accumulator. 

In other cases, you will want to set a flag though there may be a number of interven- 
ing instructions before you test it. In these cases, you must check the operation of 
the intervening instructions to be sure that they do not affect the desired flag. 

The flags set by each instruction are detailed in the individual instructions in 
Chapter 6 of this manual. 

Details of Flag Usage. Six flag registers are set or cleared by most arithmetic 
operations to reflect certain properties of the result of the operation. They follow 
these rules below, where "set" means set to 1 and "clear" means cler to 0. Further 
discussion of each of these flags follows the concise description. 
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CF is set if the operation resulted in a carry out of (from addition) or a borrow 
into (from subtraction) the high-order bit of the result; otherwise CF is 
cleared. 

AF is set if the operation resulted in a carry out of (from addition) or borrow into 
(from subtraction) the low-order four bits of the result; otherwise AF is 
cleared. 

ZF is set if the result of the operation is zero; otherwise ZF is cleared. 

SF is set if the high-order bit of the result is set; otherwise SF is cleared. 

PF is set if the modulo 2 sum of the low-order eight bits of the result of the 
operation is (even parity); otherwise PF is cleared (odd parity). 

OF is set if the signed operation resulted in an overflow, i.e., the operation 
resulted in a carry into the high-order bit of the result but not a carry out of the 
high-order bit, or vice versa; otherwise OF is cleared. 

Carry Flag. As its name implies, the carry flag is commonly used to indicate 
whether an addition causes a "carry" into the next higher order digit. (However, the 
increment and decrement instructions (INC, DEC) do not affect CF.) The carry flag 
is also used as a "borrow" flag in subtractions. 

The logical AND, OR, and XOR instructions also affect CF. These instructions set 
or reset particular bits of their destination (register or memory). See the descriptions 
of the logic instruction in Chapter 6. 

The rotate and shift instructions move the contents of the operand (registers or 
memory) one or more positions to the left or right. They treat the carry flag as 
though it were an extra bit of the operand. The original value in CF is only preserved 
by RCL and RCR. Otherwise it is simply replaced with the next bit rotated out of the 
source, i.e., the high-order bit if an RCL is used, the low-order bit if RCR. 

Example: 

Addition of two one-byte numbers can produce a carry out of the high-order bit: 



Bit Number: 7654 3210 

AEH- 1010 1110B 

+ 74H- 0111 0100B 

122H 0010 0010B-22H ;carry flag - 1 



An addition that causes a carry out of the high-order bit of the destination sets the 
flag to 1 ; an addition that does not cause a carry resets the flag to zero. 



Sign Flag. The high-order bit of the result of operations on registers or memory can 
be interpreted as a sign. Instructions that affect the sign flag set the flag equal to this 
high-order bit. A zero indicates a positive value; a one indicates a negative value. 
This value is duplicated in the sign flag so that conditional jump instructions can test 
for positive and negative values. The high order bit for byte value is bit 7; for word 
values it is bit 15. 
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Zero Flag. Certain instructions set the zero flag to one. This indicates that the last 
operation to affect ZF resulted in all zeros in the destination (register or memory). If 
that result was other than zero, then ZF is reset to 0. A result that has a carry and a 
zero result sets both flags, as shown below: 

10100111 
+ 01011001 



00000000 Carry Flag = 1 
Zero Flag = 1 
meaning yes, zero 



Parity Flag . Parity is determined by counting the number of one bits set in the low 
order 8 bits of the destination of the last operation to affect PF. Instructions that 
affect the parity flag set the flag to one for even parity and reset the flag to zero to 
indicate odd parity. 

Auxiliary Carry Flag. The auxiliary carry flag indicates a carry out of bit 3 of the 
accumulator. You cannot test this flag directly in your program; it is present to 
enable the Decimal Adjust instructions to perform their function. 

The auxiliary carry flag is affected by all add, subtract, increment, decrement, com- 
pare, and all logical AND, OR, and XOR instructions. 
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APPENDIX C 
RESERVED WORDS 



DUAL FUNCTION KEYWORD/SYMBOLS 
AND NOT OR 



SHL 



SHR 



XOR 



SYMBOLS 












AAA 


ENTER 


FLDENV 


FXCH 


JNP 


PUSH 


AAD 


ES 


FLDL2E 


FXTRACT 


JNS 


PUSHA 


AAM 


ESC 


FLDL2T 


FYL2X 


JNZ 


PUSHF 


AAS 


F2XM1 


FLDLG2 


FYL2XP1 


JO 


RCL 


ADC 


FABS 


FLDLN2 


HLT 


JP 


RCR 


ADD 


FADD 


FLDPI 


IDIV 


JPE 


REP 


AH 


FADDP 


FLDZ 


IMUL 


JPO 


REPE 


AL 


FBLD 


FMUL 


IN 


JS 


REPNE 


AX 


FBSTP 


FMULP 


INC 


JZ 


REPNZ 


BH 


FCHS 


FNCLEX 


INS 


LAHF 


REPZ 


BL 


FCLEX 


FNDISI 


INSB 


LDS 


RET 


BOUND 


FCOM 


FNENI 


INSW 


LEA 


ROL 


BP 


FCOMP 


FNINIT 


INT 


LEAVE 


ROR 


BX 


FCOMPP 


FNOP 


INTO 


LES 


SAHF 


CALL 


FDECSTP 


FNSAVE 


IRET 


LOCK 


SAL 


CBW 


FDISI 


FNSTCW 


JA 


LODS 


SAR 


CH 


FDIV 


FNSTENV 


JAE 


LODSB 


SBB 


CL 


FDIVP 


FNSTSW 


JB 


LODSW 


SCAS 


CLC 


FDIVR 


FPATAN 


JBE 


LOOP 


SCASB 


CLD 


FDIVRP 


FPREM 


JC 


LOOPE 


SCASW 


CLI 


FENI 


FPTAN 


JCXZ 


LOOPNE 


SI 


CMC 


FFREE 


FRNDINT 


JE 


LOOPNZ 


SP 


CMP 


FIADD 


FRSTOR 


JG 


LOOPZ 


SS 


CMPS 


FICOM 


FSAVE 


JGE 


MOV 


ST 


CMPSB 


FICOMP 


FSCALE 


JL 


MOVS 


STC 


CMPSW 


FIDIV 


FSQRT 


JLE 


MOVSB 


STD 


CS 


FIDIVR 


FST 


JMP 


MOVSW 


STI 


CWD 


FILD 


FSTCW 


JNA 


MUL 


STOS 


CX 


FIMUL 


FSTENV 


JNAE 


NEG 


STOSB 


DAA 


FINCSTP 


FSTP 


JNB 


NIL 


STOSW 


DAS 


FINIT 


FSTSW 


JNBE 


NOP 


SUB 


DEC 


FIST 


FSUB 


JNC 


OUT 


TEST 


DH 


FISTP 


FSUBP 


JNE 


OUTS 


WAIT 


Dl 


FISUB 


FSUBR 


JNG 


OUTSB 


XCHG 


DIV 


FISUBR 


FSUBRP 


JNGE 


OUTSW 


XLAT 


DL 


FLD 


FTST 


JNL 


POP 


XLATB 


DS 


FLD1 


FWAIT 


JNLE 


POPA 


??SEG 


DX 


FLDCW 


FXAM 


JNO 


POPF 




NON-CONFLICTING KEYWORDS 








DA 


INCLUDE 


NOERRORPRINT 


NOPR 


PAGEWIDTH 


SB 


DATE 


LI 


NOGE 


NOPRINT 


PAGING 


STACK 


DEBUG 


LIST 


NOGEN 


NOSB 


PI 


SYMBOLS 


EJ 


M1 


NOLI 


NOSYMBOLS 


PL 


TITLE 


EJECT 


MACRO 


NOLIST 


NOTY 


PR 


TT 


EP 


MEMORY 


NOMACRO 


NOTYPE 


PRINT 


TY 


ERRORPRINT 


MOD186 


NOMR 


NOXR 


PW 


TYPE 


GEN 


MR 


NOOBJECT 


NOXREF 


RESTORE 


WF 


GENONLY 


NODB 


NOOJ 


OBJECT 


RS 


WORKFILES 


GO 


NODEBUG 


NOPAGING 


OJ 


SA 


XR 


IC 


NOEP 


NOPI 


PAGELENGTH 


SAVE 


XREF 


HANDS-OFF KEYWORDS 










ABS 


DWORD 


GT 


NE 


PTR 


SEG 


ASSUME 


END 


HIGH 


NEAR 


PUBLIC 


SEGFIX 


AT 


ENDM 


INPAGE 


NOSEGFIX 


PURGE 


SEGMENT 


BYTE 


ENDP 


LABEL 


NOTHING 


QWORD 


SHORT 


CODEMACRO 


ENDS 


LE 


OFFSET 


RECORD 


SIZE 


COMMON 


EQ 


LENGTH 


ONLY186 


RELB 


STRUC 


DB 


EQU 


LOW 


ORG 


RELW 


TBYTE 


DD 


EVEN 


LT 


PAGE 


RFIX 


THIS 


DQ 


EXTRN 


MASK 


PARA 


RFIXM 


TYPE 


DT 


FAR 


MOD 


PREFX 


RNFIX 


WIDTH 


DUP 


GE 


MODRM 


PROC 


RNFIXM 


WORD 


DW 


GROUP 


NAME 


PROCLEN 


RWFIX 


? 
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APPENDIX D 
MPL BUILT-IN FUNCTIONS 



The following is a list of all MPL built-in functions. 
%'text end-of-line or %'text' 
%(balanced-text) 
XC I 

X C ( chart 

%*DEF\HE(macro-name[parameter-list]) [LOCAL local-list] (macro-body) 
%n text-n-characters-long 
%EQS{arg1,arg2) 
%EVAL( expression) 
%EXIT 

%GES(arg1,arg2) 
%GTS(arg1,arg2) 

%IF {expression) THEN (balanced-textl) [ELSE {balanced-text2)] Fl 
%IN 

%LEN(balanced-text) 
%LES(arg1,arg2) 
%LTS{arg1,arg2) 

%MATCH(identifier1 delimiter identified) (balanced-text) 
%M ETACH AR(balanced-text) 
%UES(arg1,arg2) 
%OUT(balanced-text) 
%REPEAT (expression) (balanced-text) 
%SET(macro-id, expression) 
%S\JBSTH(balanced-text, expression 1 ,expression2) 
%WHILE (expression) (balanced-text) 
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APPENDIX E 

INSTRUCTIONS IN 

HEXADECIMAL ORDER 



00 00000000 


MOD 


REG 


R/M 


ADD 


EA.REG 


01 00000001 


MOD 


REG 


R/M 


ADD 


EA,REG 


02 00000010 


MOD 


REG 


R/M 


ADD 


REG,EA 


03 00000011 


MOD 


REG 


R/M 


ADD 


REG,EA 


04 00000100 








ADD 


AL,DATA8 


05 00000101 








ADD 


AX,DATA16 


06 00000110 








PUSH 


ES 


07 00000111 








POP 


ES 


08 00001000 


MOD 


REG 


R/M 


OR 


EA,REG 


09 00001001 


MOD 


REG 


R/M 


OR 


EA.REG 


A 00001010 


MOD 


REG 


R/M 


OR 


REG.EA 


OB 00001011 


MOD 


REG 


R/M 


OR 


REG,EA 


0C 00001100 








OR 


AL.DATA8 


0D 00001101 








OR 


AX.DATA16 


0E 00001110 








PUSH 


CS 


OF 00001111 








(not used) 


10 00010000 


MOD 


REG 


R/M 


ADC 


EA.REG 


11 00010001 


MOD 


REG 


R/M 


ADC 


EA,REG 


12 00010010 


MOD 


REG 


R/M 


ADC 


REA.EA 


13 00010011 


MOD 


REG 


R/M 


ADC 


REG,EA 


14 00010100 








ADC 


AL.DATA8 


15 00010101 








ADC 


AX.DATA16 


16 00010110 








PUSH 


SS 


17 00010111 








POP 


SS 


18 00011000 


MOD 


REG 


R/M 


SBB 


EA.REG 


19 00011001 


MOD 


REG 


R/M 


SBB 


EA.REG 


1A 00011010 


MOD 


REG 


R/M 


SBB 


REG.EA 


1B 00011011 


MOD 


REG 


R/M 


SBB 


REG.EA 


1C 00011100 








SBB 


AL.DATA8 


1D 00011101 








SBB 


AX.DATA16 


1E 00011110 








PUSH 


DS 


1F 00011111 








POP 


DS 


20 00100000 


MOD 


REG 


R/M 


AND 


EA.REG 


21 00100001 


MOD 


REG 


R/M 


AND 


EA.REG 


22 00100010 


MOD 


REG 


R/M 


AND 


REG.EA 


23 00100011 


MOD 


REG 


R/M 


AND 


REG.EA 


24 00100100 








AND 


AL.DATA8 


25 00100101 








AND 


AX.DATA16 


26 00100110 








ES: 




27 00100111 








DAA 




28 00101000 


MOD 


REG 


R/M 


SUB 


EA.REG 


29 00101001 


MOD 


REG 


R/M 


SUB 


EA.REG 


2 A 00101010 


MOD 


REG 


R/M 


SUB 


REG.EA 


2B 00101011 


MOD 


REG 


R/M 


SUB 


REG.EA 


2C 00101100 








SUB 


AL.DATA8 


2D 00101101 








SUB 


AX.DATA16 


2E 00101110 








CS: 




2F 00101111 








DAS 




30 00110000 


MOD 


REG 


R/M 


XOR 


EA.REG 


31 00110001 


MOD 


REG 


R/M 


XOR 


EA.REG 


32 00110010 


MOD 


REG 


R/M 


XOR 


REG.EA 


33 00110011 


MOD 


REG 


R/M 


XOR 


REG.EA 


34 00110100 








XOR 


AL.DATA8 


35 00110101 








XOR 


AX.DATA16 


36 00110110 








SS: 




37 00110111 








AAA 




38 00111000 


MOD 


REG 


R/M 


CMP 


EA.REG 


39 00111001 


MOD 


REG 


R/M 


CMP 


EA.REG 


3A 00111010 


MOD 


REG 


R/M 


CMP 


REG.EA 


3B 00111011 


MOD 


REG 


R/M 


CMP 


REG.EA 


3C 00111100 








CMP 


AL.DATA8 


3D 00111101 








CMP 


AX.DATA16 


3E 00111110 








DS: 




3F 00111111 








AAS 




40 01000000 








INC 


AX 


41 01000001 








INC 


CX 



BYTE ADD (REG) TO EA 
WORD ADD (REG) TO EA 
BYTE ADD (EA) TO REG 
WORD ADD (EA) TO REG 
BYTE ADD DATA TO REG AL 
WORD ADD DATA TO REG AX 
PUSH (ES) ON STACK 
POP STACK TO REG ES 
BYTE OR (REG) TO EA 
WORD OR (REG) TO EA 
BYTE OR (EA) TO REG 
WORD OR (EA) TO REG 
BYTE OR DATA TO REG AL 
WORD OR DATA TO REG AX 
PUSH (CS) ON STACK 

BYTE ADD (REG) W/ CARRY TO EA 

WORD ADD (REG) W/ CARRY TO EA 

BYTE ADD (EA) W/ CARRY TO REG 

WORD ADD (EA) W/ CARRY TO REG 

BYTE ADD DATA W/CARRY TO REG AL 

WORD ADD DATA W/ CARRY TO REG AX 

PUSH (SS) ON STACK 

POP STACK TO REG SS 

BYTE SUB (REG) W/ BORROW FROM EA 

WORD SUB (REG) W/ BORROW FROM EA 

BYTE SUB (EA) W/ BORROW FROM REG 

WORD SUB (EA) W/ BORROW FROM REG 

BYTE SUB DATA W/ BORROW FROM REG AL 

WORD SUB DATA W/ BORROW FROM REG AX 

PUSH (DS) ON STACK 

POP STACK TO REG DS 

BYTE AND (REG) TO EA 

WORD AND (REG) TO EA 

BYTE AND (EA) TO REG 

WORD AND (EA) TO REG 

BYTE AND DATA TO REG AL 

WORD AND DATA TO REG AX 

SEGMENT OVERIDEW/ SEGMENT REG ES 

DECIMAL ADJUST FOR ADD 

BYTE SUBTRACT (REG) FROM EA 

WORD SUBTRACT (REG) FROM EA 

BYTE SUBTRACT (EA) FROM REG 

WORD SUBTRACT (EA) FROM REG 

BYTE SUBTRACT DATA FROM REG AL 

WORD SUBTRACT DATA FROM REG AX 

SEGMENT OVERIDEW/ SEGMENT REG CS 

DECIMAL ADJUST FOR SUBTRACT 

BYTE XOR (REG) TO EA 

WORD XOR (REG) TO EA 

BYTE XOR (EA) TO REG 

WORD XOR (EA) TO REG 

BYTE XOR DATA TO REG AL 

WORD XOR DATA TO REG AX 

SEGMENT OVERIDE W/ SEGMENT REG SS 

ASCII ADJUST FOR ADD 

BYTE COMPARE (EA) WITH (REG) 

WORD COMPARE (EA) WITH (REG) 

BYTE COMPARE (REG) WITH (EA) 

WORD COMPARE (REG) WITH (EA) 

BYTE COMPARE DATA WITH (AL) 

WORD COMPARE DATA WITH (AX) 

SEGMENT OVERIDE W/ SEGMENT REG DS 

ASCII ADJUST FOR SUBTRACT 

INCREMENT (AX) 

INCREMENT (CX) 
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ASM86 



42 01000010 

43 01000011 

44 01000100 

45 01000101 

46 01000110 

47 01000111 

48 01001000 

49 01001001 
4A 01001010 
4B 01001011 
4C 01001100 
4D 01001101 
4E 01001110 
4F 01001111 

50 01010000 

51 01010001 

52 01010010 

53 01010011 

54 01010100 

55 01010101 

56 01010110 

57 01010111 

58 01011000 

59 01011001 
5A 01011010 
5B 01011011 
5C 01011100 
5D 01011101 
5E 01011110 
5F 01011111 

60 01100000 

61 01100001 

62 01100010 

63 01100011 

64 01100100 

65 01100101 

66 01100110 

67 01100111 

68 01101000 

69 01101001 
6A 01101010 
6B 01101011 
6C 01101100 
6D 01101101 
6E 01101110 
6F 01101111 

70 01110000 

71 01110001 

72 01110010 

73 01110011 

74 01110100 

75 01110101 

76 01110110 

77 01110111 

78 01111000 

79 01111001 
7A 01111010 
7B 01111011 
7C 01111100 
7D 01111101 
7E 01111110 
7F 01111111 

80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 
80 10000000 

80 10000000 

81 10000001 
81 10000001 
81 10000001 



MOD REG 



MOD 
MOD 



REG 
REG 



MOD 
MOD 
MOD 
MOD 
MOD 
MOD 
MOD 
MOD 
MOD 
MOD 
MOD 



000 
001 
010 
011 
100 
101 
110 
111 
000 
001 
010 



INC 

INC 

INC 

INC 

INC 

INC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

DEC 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

PUSH 

POP 

POP 

POP 

POP 

POP 

POP 

POP 

POP 

PUSHA 

POPA 
R/M BOUND 

(not used) 

(not used) 

(not used) 

(not used) 

(not used) 

PUSH 
R/M IMUL 

PUSH 
R/M IMUL 

INS 

INS 

OUTS 

OUTS 

JO 

JNO 

JC/JB/JNAE 

JNC/JNB/JAE 

JE/JZ 

JNE/JNZ 

JBE/JNA 

JNBE/JA 

JS 

JNS 

JP/JPE 

JNP/JPO 

JL/JNGE 

JNL/JGE 

JLE/JNG 

JNLE/JG 
R/M ADD 
R/M OR 
R/M ADC 
R/M SBB 
R/M AND 
R/M SUB 
R/M XOR 
R/M CMP 
R/M ADD 
R/M OR 
R/M ADC 



DX 

DX 

SP 

BP 

SI 

Dl 

AX 

CX 

DX 

BX 

SP 

BP 

SI 

Dl 

AX 

CX 

DX 

BX 

SP 

BP 

SI 

Dl 

AX 

CX 

DX 

BX 

SP 

BP 

SI 

Dl 



REG,EA 



INCREMENT (DX) 

INCREMENT (BX) 

INCREMENT (SP) 

INCREMENT (BP) 

INCREMENT (SI) 

INCREMENT (Dl) 

DECREMENT (AX) 

DECREMENT (CX) 

DECREMENT (DX) 

DECREMENT (BX) 

DECREMENT (SP) 

DECREMENT (BP) 

DECREMENT (SI) 

DECREMENT (Dl) 

PUSH (AX) ON STACK 

PUSH (CX) ON STACK 

PUSH (DX) ON STACK 

PUSH (BX) ON STACK 

PUSH (SP) ON STACK 

PUSH (BP) ON STACK 

PUSH (SI) ON STACK 

PUSH (Dl) ON STACK 

POP STACK TO REG AX 

POP STACK TO REG CX 

POP STACK TO REG DX 

POP STACK TO REG BX 

POP STACK TO REG SP 

POP STACK TO REG BP 

POP STACK TO REG SI 

POP STACK TO REG Dl 

PUSH ALL DATA, INDEX, AND POINTER REGISTEI 

POP ALL DATA, INDEX, AND POINTER REGISTER! 

CHECK INDEX IN REG AGAINST BOUNDS AT EA 



DATA1 6 PUSH WORD DATA ON STACK 

REG,EA,DATA16 MULTIPLY (EA) BY WORD DATA; SIGNED 

DATA8 PUSH BYTE DATA ON STACK; SIGN-EXTEND 

REG,EA,DATA8 MULTIPLY (EA) BY BYTE DATA; SIGNED 

DST8 BYTE INPUT, STRING OP 

DST16 WORD INPUT, STRING OP 

DST8 BYTE OUTPUT, STRING OP 

DST1 6 WORD OUTPUT, STRING OP 

DISP8 JUMP ON OVERFLOW 

DISP8 JUMP ON NOT OVERFLOW 

DISP8 JUMP ON BELOW/NOT ABOVE OR EQUAL 

DISP8 JUMP ON NOT BELOW/ABOVE OR EQUAL 

DISP8 JUMP ON EQUAL/ZERO 

DISP8 JUMP ON NOT EQUAL/NOT ZERO 

DISP8 JUMP ON BELOW OR EQUAL/NOT ABOVE 

DISP8 JUMP ON NOT BELOW OR EQUAL/ABOVE 

DISP8 JUMP ON SIGN 

DISP8 JUMP ON NOT SIGN 

DISP8 JUMP ON PARITY/PARITY EVEN 

DISP8 JUMP ON NOT PARITY/PARITY ODD 

DISP8 JUMP ON LESS/NOT GREATER OR EQUAL 

DISP8 JUMP ON NOT LESS/GREATER OR EQUAL 

DISP8 JUMP ON LESS OR EQUAL/NOT GREATER 

DISP8 JUMP ON NOT LESS OR EQUAL/GREATER 

EA.DATA8 BYTE ADD DATA TO EA 

EA.DATA8 BYTE OR DATA TO EA 

EA,DATA8 BYTE ADD DATA W/CARRY TO EA 

EA.DATA8 BYTE SUB DATA W/BORROW FROM EA 

EA.DATA8 BYTE AND DATA TO EA 

EA.DATA8 BYTE SUBTRACT DATA FROM EA 

EA.DATA8 BYTE XOR DATA TO EA 

EA.DATA8 BYTE COMPARE DATA WITH (EA) 

EA.DATA1 6 WORD ADD DATA TO EA 

EA.DATA1 6 WORD OR DATA TO EA 

EA.DATA1 6 WORD ADD DATA W/CARRY TO EA 
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Instructions in Hexadecimal Order 



81 10000001 


MOD 


011 


R/M 


SBB 


EA.DATA16 


81 10000001 


MOD 


100 


R/M 


AND 


EA.DATA16 


81 10000001 


MOD 


101 


R/M 


SUB 


EA.DATA16 


81 10000001 


MOD 


110 


R/M 


XOR 


EA,DATA16 


81 10000001 


MOD 


111 


R/M 


CMP 


EA,DATA16 


82 10000010 


MOD 


000 


R/M 


ADD 


EA.DATA8 


82 10000010 


MOD 


001 


R/M 


(not used) 




82 10000010 


MOD 


010 


R/M 


ADC 


EA,DATA8 


82 10000010 


MOD 


011 


R/M 


SBB 


EA,DATA8 


82 10000010 


MOD 


100 


R/M 


(not used) 




82 10000010 


MOD 


101 


R/M 


SUB 


EA.DATA8 


82 10000010 


MOD 


110 


R/M 


(not used) 




82 10000010 


MOD 


111 


R/M 


CMP 


EA.DATA8 


83 10000011 


MOD 


000 


R/M 


ADD 


EA,DATA8 


83 10000011 


MOD 


001 


R/M 


(not used) 




83 10000011 


MOD 


010 


R/M 


ADC 


EA,DATA8 


83 10000011 


MOD 


011 


R/M 


SBB 


EA,DATA8 


83 10000011 


MOD 


100 


R/M 


(not used) 




83 10000011 


MOD 


101 


R/M 


SUB 


EA.DATA8 


83 10000011 


MOD 


110 


R/M 


(not used) 




83 10000011 


MOD 


111 


R/M 


CMP 


EA.DATA8 


84 10000100 


MOD 


REG 


R/M 


TEST 


EA,REG 


85 10000101 


MOD 


REG 


R/M 


TEST 


EA,REG 


86 10000110 


MOD 


REG 


R/M 


XCHG 


REG,EA 


87 10000111 


MOD 


REG 


R/M 


XCHG 


REG,EA 


88 10001000 


MOD 


REG 


R/M 


MOV 


EA,REG 


89 10001001 


MOD 


REG 


R/M 


MOV 


EA.REG 


8A 10001010 


MOD 


REG 


R/M 


MOV 


REG.EA 


8B 10001011 


MOD 


REG 


R/M 


MOV 


REG.EA 


8C 10001100 


MOD 


0SR 


R/M 


MOV 


EA,SR 


8C 10001100 


MOD 


1 — 


R/M 


(not used) 




8D 10001101 


MOD 


REG 


R/M 


LEA 


REG.EA 


8E 10001110 


MOD 


0SR 


R/M 


MOV 


SR,EA 


8E 10001110 


MOD 


— 


R/M 


(not used) 




8F 10001111 


MOD 


000 


R/M 


POP 


EA 


8F 10001111 


MOD 


001 


R/M 


(not used) 




8F 10001111 


MOD 


010 


R/M 


(not used) 




8F 10001111 


MOD 


011 


R/M 


(not used) 




8F 10001111 


MOD 


100 


R/M 


(not used) 




8F 10001111 


MOD 


101 


R/M 


(not used) 




8F 10001111 


MOD 


110 


R/M 


(not used) 




8F 10001111 


MOD 


111 


R/M 


(not used) 




90 10010000 








XCHG 


AX, AX 


91 10010001 








XCHG 


AX,CX 


92 10010010 








XCHG 


AX.DX 


93 10010011 








XCHG 


AX,BX 


94 10010100 








XCHG 


AX.SP 


95 10010101 








XCHG 


AX.BP 


96 10010110 








XCHG 


AX.SI 


97 10010111 








XCHG 


AX.DI 


98 10011000 








CBW 




99 10011001 








CWD 




9A 10011010 








CALL 


DISP16.SEG16 


9B 10011011 








WAIT 




9C 10011100 








PUSHF 




9D 10011101 








POPF 




9E 10011110 








SAHF 




9F 10011111 








LAHF 




A0 10100000 








MOV 


AL,ADDR16 


A1 10100001 








MOV 


AX.ADDR16 


A2 10100010 








MOV 


ADDR16.AL 


A3 10100011 








MOV 


ADDR16.AX 


A4 10100100 








MOVS 


DST8.SRC8 


A5 10100101 








MOVS 


DST16.SRC16 


A6 10100110 








CMPS 


SIPTR.DIPTR 


A7 10100111 








CMPS 


SIPTR,DIPTR 


A8 10101000 








TEST 


AL.DATA8 


A9 10101001 








TEST 


AX.DATA16 


AA10101010 








STOS 


DST8 


AB10101011 








STOS 


DST16 


AC10101100 








LODS 


SRC8 


AD10101101 








LODS 


SRC16 


AE10101110 








SCAS 


DIPTR8 



WORD SUB DATA W/ BORROW FROM EA 

WORD AND DATA TO EA 

WORD SUBTRACT DATA FROM EA 

WORD XOR DATA TO EA 

WORD COMPARE DATA WITH (EA) 

BYTE ADD DATA TO EA 

BYTE ADD DATA W/ CARRY TO EA 
BYTE SUB DATA W/ BORROW FROM EA 

BYTE SUBTRACT DATA FROM EA 

BYTE COMPARE DATA WITH (EA) 
WORD ADD DATA TO EA 

WORD ADD DATA W/ CARRY TO EA 
WORD SUB DATA W/ BORROW FROM EA 

WORD SUBTRACT DATA FROM EA 

WORD COMPARE DATA WITH (EA) 

BYTE TEST (EA) WITH (REG) 

WORD TEST (EA) WITH (REG) 

BYTE EXCHANGE (REG) WITH (EA) 

WORD EXCHANGE (REG) WITH (EA) 

BYTE MOVE (REG) TO EA 

WORD MOVE (REG) TO EA 

BYTE MOVE (EA) TO REG 

WORD MOVE (EA) TO REG 

WORD MOVE (SEGMENT REG SR) TO EA 

LOAD EFFECTIVE ADDRESS OF EA TO REG 
WORD MOVE (EA) TO SEGMENT REG SR 

POP STACK TO EA 



EXCHANGE (AX) WITH (AX), (NOP) 

EXCHANGE (AX) WITH (CX) 

EXCHANGE (AX) WITH (DX) 

EXCHANGE (AX) WITH (BX) 

EXCHANGE (AX) WITH (SP) 

EXCHANGE (AX) WITH (BP) 

EXCHANGE (AX) WITH (SI) 

EXCHANGE (AX) WITH (Dl) 

BYTE CONVERT (AL) TO WORD (AX) 

WORD CONVERT (AX) TO DOUBLE WORD 

DIRECT INTER SEGMENT CALL 

WAIT FOR TEST SIGNAL 

PUSH FLAGS ON STACK 

POP STACK TO FLAGS 

STORE (AH) INTO FLAGS 

LOAD REG AH WITH FLAGS 

BYTE MOVE (ADDR) TO REG AL 

WORD MOVE (ADDR) TO REG AX 

BYTE MOVE (AL) TO ADDR 

WORD MOVE (AX) TO ADDR 

BYTE MOVE, STRING OP 

WORD MOVE, STRING OP 

COMPARE BYTE, STRING OP 

COMPARE WORD, STRING OP 

BYTE TEST (AL) WITH DATA 

WORD TEST (AX) WITH DATA 

BYTE STORE, STRING OP 

WORD STORE, STRING OP 

BYTE LOAD, STRING OP 

WORD LOAD, STRING OP 

BYTE SCAN, STRING OP 
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AF 10101111 








SCAS 


DIPTR16 


BO 10110000 








MOV 


AL,DATA8 


B1 10110001 








MOV 


CL.DATA8 


B2 10110010 








MOV 


DL,DATA8 


B3 10110011 








MOV 


BL,DATA8 


B4 10110100 








MOV 


AH.DATA8 


B5 10110101 








MOV 


CH,DATA8 


B6 10110110 








MOV 


DH,DATA8 


B7 10110111 








MOV 


BH.DATA8 


B8 10111000 








MOV 


AX.DATA16 


B9 10111001 








MOV 


CX,DATA16 


BA10111010 








MOV 


DX.DATA16 


BB10111011 








MOV 


BX,DATA16 


BC10111100 








MOV 


SP,DATA16 


BD10111101 








MOV 


BP.DATA16 


BE10111110 








MOV 


SI,DATA16 


BF10111111 








MOV 


DI,DATA16 


CO 11000000 


MOD 


000 


R/M 


ROL 


EA,DATA8 


CO 11000000 


MOD 


001 


R/M 


ROR 


EA,DATA8 


CO 11000000 


MOD 


010 


R/M 


RCL 


EA.DATA8 


CO 11000000 


MOD 


011 


R/M 


RCR 


EA, DATA8 


CO 11000000 


MOD 


100 


R/M 


SHL/SAL 


EA.DATA8 


CO 11000000 


MOD 


101 


R/M 


SHR 


EA,DATA8 


CO 11000000 


MOD 


110 


R/M 


(not used) 




CO 11000000 


MOD 


111 


R/M 


SAR 


EA,DATA8 


ci ; 1000001 


MOD 


000 


R/M 


ROL 


EA,DATA8 


C1 11000001 


MOD 


001 


R/M 


ROR 


EA.DATA8 


C1 11000001 


MOD 


010 


R/M 


RCL 


EA,DATA8 


C1 11000001 


MOD 


011 


R/M 


RCR 


EA,DATA8 


C1 11000001 


MOD 


100 


R/M 


SHL/SAL 


EA,DATA8 


C1 11000001 


MOD 


101 


R/M 


SHR 


EA.DATA8 


C1 11000001 


MOD 


110 


R/M 


(not used) 




C1 11000001 


MOD 


111 


R/M 


SAR 


EA.DATA8 


C2 11000010 








RET 


DATA16 


C3 11000011 








RET 




C4 11000100 


MOD 


REG 


R/M 


LES 


REG.EA 


C5 11000101 


MOD 


REG 


R/M 


LDS 


REG.EA 


C6 11000110 


MOD 


000 


R/M 


MOV 


EA,DATA8 


C6 11000110 


MOD 


001 


R/M 


(not used) 




C6 11000110 


MOD 


010 


R/M 


(not used) 




C6 11000110 


MOD 


011 


R/M 


(not used) 




C6 11000110 


MOD 


100 


R/M 


(not used) 




C6 11000110 


MOD 


101 


R/M 


(not used) 




C6 11000110 


MOD 


110 


R/M 


(not used) 




C6 11000110 


MOD 


111 


R/M 


(not used) 




C7 11000111 


MOD 


000 


R/M 


MOV 


EA,DATA16 


C7 11000111 


MOD 


001 


R/M 


(not used) 




C7 11000111 


MOD 


010 


R/M 


(not used) 




C7 11000111 


MOD 


011 


R/M 


(not used) 




C7 11000111 


MOD 


100 


R/M 


(not used) 




C7 11000111 


MOD 


101 


R/M 


(not used) 




C7 11000111 


MOD 


110 


R/M 


(not used) 




C7 11000111 


MOD 


111 


R/M 


(not used) 




C8 11001000 








ENTER 


DATA16.DATA8 


C9 11001001 








LEAVE 




CA11001010 








RET 


DATA16 


CB11001011 








RET 




CC11001100 








INT 


3 


CD11001101 








INT 


TYPE 


CE11001110 








INTO 




CF11001111 








IRET 




DO 11010000 


MOD 


000 


R/M 


ROL 


EA,1 


DO 11010000 


MOD 


001 


R/M 


ROR 


EA,1 


DO 11010000 


MOD 


010 


R/M 


RCL 


EA,1 


DO 11010000 


MOD 


011 


R/M 


RCR 


EA,1 


DO 11010000 


MOD 


100 


R/M 


SHL 


EA,1 


DO 11010000 


MOD 


101 


R/M 


SHR 


EA,1 


DO 11010000 


MOD 


110 


R/M 


(not used) 




DO 11010000 


MOD 


111 


R/M 


SAR 


EA,1 


D1 11010001 


MOD 


000 


R/M 


ROL 


EA,1 



WORD SCAN, STRING OP 

BYTE MOVE DATA TO REG AL 

BYTE MOVE DATA TO REG CL 

BYTE MOVE DATA TO REG DL 

BYTE MOVE DATA TO REG BL 

BYTE MOVE DATA TO REG AH 

BYTE MOVE DATA TO REG CH 

BYTE MOVE DATA TO REG DH 

BYTE MOVE DATA TO REG BH 

WORD MOVE DATA TO REG AX 

WORD MOVE DATA TO REG CX 

WORD MOVE DATA TO REG DX 

WORD MOVE DATA TO REG BX 

WORD MOVE DATA TO REG SP 

WORD MOVE DATA TO REG BP 

WORD MOVE DATA TO REG SI 

WORD MOVE DATA TO REG Dl 

BYTE ROTATE EA LEFT DATA8 BITS 

BYTE ROTATE EA RIGHT DATA8 BITS 

BYTE ROTATE EA LEFT THRU CARRY DATA8 E 

BYTE ROTATE EA RIGHT THRU CARRY DATA8 

BYTE SHIFT EA LEFT DATA8 BITS 

BYTE SHIFT EA RIGHT DATA8 BITS 

BYTE SHIFT SIGNED EA RIGHT DATA8 BITS 
WORD ROTATE EA LEFT DATA8 BITS 
WORD ROTATE EA RIGHT DATA8 BITS 
WORD ROTATE EA LEFT THRU CARRY DATA8 
WORD ROTATE EA RIGHT THRU CARRY DATA! 
WORD SHIFT EA LEFT DATA8 BITS 
WORD SHIFT EA RIGHT DATA8 BITS 

WORD SHIFT SIGNED EA RIGHT DATA8 BITS 
INTRA SEGMENT RETURN, ADD DATA TO REG SP 
INTRA SEGMENT RETURN 
WORD LOAD REG AND SEGMENT REG ES 
WORD LOAD REG AND SEGMENT REG DS 
BYTE MOVE DATA TO EA 



WORD MOVE DATA TO EA 



PERFORM ENTER SEQUENCE 
PERFORM LEAVE SEQUENCE 

INTER SEGMENT RETURN, ADD DATA TO REG SP 

INTER SEGMENT RETURN 

TYPE3INTERRUPT 

TYPED INTERRUPT 

INTERRUPTON OVERFLOW 

RETURN FROM INTERRUPT 

BYTE ROTATE EA LEFT 1 BIT 

BYTE ROTATE EA RIGHT 1 BIT 

BYTE ROTATE EA LEFT THRU CARRY 1 BIT 

BYTE ROTATE EA RIGHT THRU CARRY 1 BIT 

BYTE SHIFT EA LEFT 1 BIT 

BYTE SHIFT EA RIGHT 1 BIT 

BYTE SHIFT SIGNED EA RIGHT 1 BIT 
WORD ROTATE EA LEFT 1 BIT 
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D1 11010001 


MOD 001 


R/M 


ROR 


EA,1 


D1 11010001 


MOD 


010 


R/M 


RCL 


EA.1 


D1 11010001 


MOD 


011 


R/M 


RCR 


EA.1 


D1 11010001 


MOD 


100 


R/M 


SHL 


EA,1 


D1 11010001 


MOD 


101 


R/M 


SHR 


EA,1 


D1 11010001 


MOD 


110 


R/M 


(not used) 




D1 11010001 


MOD 


111 


R/M 


SAR 


EA,1 


D2 11010010 


MOD 


000 


R/M 


ROL 


EA,CL 


D2 11010010 


MOD 


001 


R/M 


ROR 


EA,CL 


D2 11010010 


MOD 


010 


R/M 


RCL 


EA,CL 


D2 11010010 


MOD 


011 


R/M 


RCR 


EA,CL 


D2 11010010 


MOD 


100 


R/M 


SHL 


EA,CL 


D2 11010010 


MOD 


101 


R/M 


SHR 


EA,CL 


D2 11010010 


MOD 


110 


R/M 


(not used) 




D2 11010010 


MOD 


111 


R/M 


SAR 


EA,CL 


D3 11010011 


MOD 


000 


R/M 


ROL 


EA.CL 


D3 11010011 


MOD 


001 


R/M 


ROR 


EA.CL 


D3 11010011 


MOD 


010 


R/M 


RCL 


EA,CL 


D3 11010011 


MOD 


011 


R/M 


RCR 


EA.CL 


D3 11010011 


MOD 


100 


R/M 


SHL 


EA.CL 


D3 11010011 


MOD 


101 


R/M 


SHR 


EA.CL 


D3 11010011 


MOD 


110 


R/M 


(not used) 




D3 11010011 


MOD 


111 


R/M 


SAR 


EA,CL 


D4 11010100 


00001010 




AAM 




D5 11010101 


00001010 




AAD 




D6 11010110 








(not used) 




D7 11010111 








XLAT 


TABLE 


D8 11011 — 


MOD 


— 


R/M 


ESC 


EA 


D8 11011000 


MOD 


000 


R/M 


FADD 


Short-real 


D8 11011000 


MOD 


001 


R/M 


FMUL 


Short-real 


D8 11011000 


MOD 


010 


R/M 


FCOM 


Short-real 


D8 11011000 


MOD 


011 


R/M 


FCOMP 


Short-real 


D8 11011000 


MOD 


100 


R/M 


FSUB 


Short-real 


D8 11011000 


MOD 


101 


R/M 


FSUBR 


Short-real 


D8 11011000 


MOD 


110 


R/M 


FDIV 


Short-real 


D8 11011000 


MOD 


111 


R/M 


FDIVR 


Short-real 


D8 11011000 


1 1 


000 


CD 


FADD 


ST, ST(i) 


D8 11011000 


1 1 


001 


(0 


FMUL 


ST, ST(i) 


D8 11011000 


1 1 


010 


(i) 


FCOM 


ST(i) 


D8 11011000 


1 1 


011 


(i) 


FCOMP 


ST(i) 


D8 11011000 


1 1 


100 


(i) 


FSUB 


ST, ST(i) 


D8 11011000 


1 1 


101 


(i) 


FSUBR 


ST,ST(i) 


D8 11011000 


1 1 


110 


(i) 


FDIV 


ST, ST(i) 


D8 11011000 


1 1 


111 


(i) 


FDIVR 


ST, ST(i) 


D9 11011001 


MOD 


000 


R/M 


FLD 


Short-real 


D9 11011001 


MOD 


001 


R/M 


(not used) 




D9 11011001 


MOD 


010 


R/M 


FST 


Short-real 


D9 11011001 


MOD 


011 


R/M 


FSTP 


Short-real 


D9 11011001 


MOD 


100 


R/M 


FLDENV 


14 BYTES 


D9 11011001 


MOD 


101 


R/M 


FLDCW 


2-BYTES 


D9 11011001 


MOD 


110 


R/M 


FSTENV 


14-BYTES 


D9 11011001 


MOD 


111 


R/M 


FSTCW 


2-BYTES 


D9 11011001 




000 


(i) 


FLD 


ST(i) 


D9 11011001 




001 


(i) 


FXCH 


ST(i) 


D9 11011001 




010 


000 


FNOP 




D9 11011001 




010 


001 


(not used) 




D9 11011001 




010 


01- 


(not used) 




D9 11011001 




010 


1- 


(not used) 




D9 11011001 




011 


(i) 


*(D 




D9 11011001 




100 


000 


FCHS 




D9 11011001 




100 


001 


FABS 




D9 11011001 




100 


01- 


(not used) 




D9 11011001 




100 


100 


FTST 




D9 11011001 




100 


101 


FXAM 




D9 11011001 




100 


11- 


(not used) 




D9 11011001 




101 


000 


FLD1 




D9 11011001 




101 


001 


FLDL2T 




D9 11011001 




101 


010 


FLDL2E 




D9 11011001 




101 


011 


FLDPI 




D9 11011001 




101 


100 


FLDLG2 




D9 11011001 




101 


101 


FLDLN2 




D9 11011001 




101 


110 


FLDZ 





WORD ROTATE EA RIGHT 1 BIT 
WORD ROTATE EA LEFTTHRU CARRY 1 BIT 
WORD ROTATE EARIGHTTHRU CARRY 1 BIT 
WORD SHIFT EA LEFT 1 BIT 
WORDSHIFTEARIGHT1 BIT 

WORDSHIFTSIGNEDEARIGHT1 BIT 

BYTE ROTATE EA LEFT (CL) BITS 

BYTE ROTATE EA RIGHT (CL) BITS 

BYTE ROTATE EA LEFT THRU CARRY (CL) BITS 

BYTE ROTATE EA RIGHT THRU CARRY (CL) BITS 

BYTE SHIFT EA LEFT (CL) BITS 

BYTE SHIFT EA RIGHT (CL) BITS 

BYTE SHIFT SIGNED EA RIGHT (CL) BITS 
WORD ROTATE EA LEFT (CL) BITS 

WORD ROTATE EA RIGHT (CL) BITS 

WORD ROTATE EA LEFT THRU CARRY (CL) BITS 

WORD ROTATE EA RIGHT THRU CARRY (CL) BITS 

WORD SHIFT EA LEFT (CL) BITS 

WORD SHIFT EA RIGHT (CL) BITS 

WORD SHIFT SIGNED EA RIGHT (CL) BITS 
ASCII ADJUST FOR MULTIPLY 
ASCII ADJUST FOR DIVIDE 

TRANSLATE USING (BX) 
ESCAPE TO EXTERNAL DEVICE 
ADD4-BYTEEATOST 
MULTIPLY ST BY 4-BYTE EA 
COMPARE 4-BYTE EA WITH ST 
COMPARE 4-BYTE EA WITH ST AND POP 
SUBTRACT 4-BYTE EA FROM ST 
SUBTRACT ST FROM 4-BYTE EA 
DIVIDE ST BY 4-BYTE EA 
DIVIDE 4-BYTE EA BY ST 
ADDELEMENTTOST 
MULTIPLY ST BY ELEMENT 
COMPARE ST(i) WITH ST 
COMPARE ST(i) WITH ST AND POP 
SUBTRACT ELEMENT FROM ST 
SUBTRACT ST FROM STACK ELEMENT 
DIVIDE ST BY ELEMENT 
DIVIDE ST(i) BY ST 
PUSH 4-BYTE EA TO ST 

STORE 4-BYTE REAL TO EA 
STORE 4-BYTE REAL TO EA AND POP 
LOAD 8087 ENVIRONMENT FROM EA 
LOAD CONTROL WORD FROM EA 
STORE 8087 ENVIRONMENT INTO EA 
STORE CONTROL WORD INTO EA 
PUSH ST(i) ONTO ST 
EXCHANGESTANDST(i) 
STORE ST IN ST 



CHANGE SIGN OF ST 

TAKE ABSOLUTE VALUE OF ST 

TEST ST AGAINST 0.0 

EXAMINE ST AND REPORT CONDITION CODE 

PUSH +1.0 TO ST 
PUSHIog2lOTOST 
PUSHIog2eTOST 
PUSH Pi TO ST 
PUSH log-|n2TOST 
PUSHIog e 2TOST 
PUSH ZERO TO ST 
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D9 11011001 




101 


111 


(not used) 




D9 11011001 




110 


000 


F2XM1 




D9 11011001 




110 


001 


FYL2X 




D9 11011001 




110 


010 


FPTAN 




D9 11011001 




110 


011 


FPATAN 




D9 11011001 




110 


100 


FXTRACT 




D9 11011001 




110 


101 


(not used) 




D9 11011001 




110 


110 


FDECSTP 




D9 11011001 




110 


111 


FINCSTP 




D9 11011001 




111 


000 


FPREM 




D9 11011001 




110 


001 


FYL2XP1 




D9 11011001 




111 


010 


FSQRT 




D9 11011001 




111 


011 


(not used) 




D9 11011001 




111 


100 


FRNDINT 




D9 11011001 




111 


101 


FSCALE 




D9 11011001 




111 


11- 


(not used) 




DA11011010 


MOD 


000 


R/M 


FIADD 


Short-integer 


DA11011010 


MOD 


001 


R/M 


FIMUL 


Short-integer 


DA11011010 


MOD 


010 


R/M 


FICOM 


Short-integer 


DA11011010 


MOD 


011 


RIM 


FICOMP 


Short-integer 


DA11011010 


MOD 


100 


RIM 


FISUB 


Short-integer 


DA11011010 


MOD 


101 


R/M 


FISUBR 


Short-integer 


DA11011010 


MOD 


110 


R/M 


FIDIV 


Short-integer 


DA11011010 


MOD 


111 


R/M 


FIDIVR 


Short-integer 


DA11011010 


1 1 


- 


— 


(not used) 




DB11011011 


MOD 


000 


R/M 


FILD 


Short-integer 


DB11011011 


MOD 


001 


R/M 


(not used) 




DB11011011 


MOD 


010 


R/M 


FIST 


Short integer 


DB11011011 


MOD 


011 


R/M 


FISTP 


Short-integer 


DB11011011 


MOD 


100 


R/M 


(not used) 




DB11011011 


MOD 


101 


R/M 


FLD 


Temp-real 


DB11011011 


MOD 


110 


R/M 


Reserved 




DB11011011 


MOD 


111 


R/M 


FSTP 


Temp-real 


DB11011011 




0- 


... 


Reserved 




DB11011011 




100 


000 


FENI 




DB11011011 




100 


001 


FDISI 




DB11011011 




100 


010 


FCLEX 




DB11011011 




100 


011 


FINIT 




DB11011011 




100 


1- 


Reserved 




DB11011011 




101 


... 


Reserved 




DB11011011 




11- 


... 


Reserved 




DC11011100 


MOD 


000 


R/M 


FADD 


Long-real 


DC11011100 


MOD 


001 


R/M 


FMUL 


Long-real 


DC11011100 


MOD 


010 


R/M 


FCOM 


Long-real 


DC11011100 


MOD 


011 


R/M 


FCOMP 


Long-real 


DC11011100 


MOD 


100 


R/M 


FSUB 


Long-real 


DC11011100 


MOD 


101 


R/M 


FSUBR 


Long-real 


DC11011100 


MOD 


110 


R/M 


FDIV 


Long-real 


DC11011100 


MOD 


111 


R/M 


FDIVR 


Long-real 


DC11011100 


1 1 


000 


(i) 


FADD 


ST(i),ST 


DC11011100 


1 1 


001 


(i) 


FMUL 


ST(i), ST 


DC11011100 


1 1 


010 


(i) 


*(2) 




DC11011100 


1 1 


011 


(i) 


*(3) 




DC11011100 


1 1 


100 


(i) 


FSUBR 


ST(i), ST 


DC11011100 


1 1 


101 


(i) 


FSUB 


ST(i),ST 


DC11011100 


1 1 


110 


(i) 


FDIVR 


ST(i),ST 


DC11011100 


1 1 


111 


(') 


FDIV 


ST(i), ST 


DD11011101 


MOD 


000 


R/M 


FLD 


Long-real 


DD11011101 


MOD 


001 


R/M 


Reserved 




DD11011101 


MOD 


010 


R/M 


FST 


Long-real 


DD11011101 


MOD 


011 


R/M 


FSTP 


Long-real 


DD11011101 


MOD 


100 


R/M 


FRSTOR 


94-BYTES 


DD11011101 


MOD 


101 


R/M 


Reserved 




DD11011101 


MOD 


110 


R/M 


FSAVE 


94-BYES 


DD11011101 


MOD 


111 


R/M 


FSTSW 


2-BYTES 


DD11011101 




000 


(i) 


FFREE 


ST(i) 


DD11011101 




001 


(i) 


*(4) 




DD11011101 




010 


(i) 


FST 


ST(i) 


DD11011101 




011 


(i) 


FSTP 


ST(i) 


DD11011101 




1- 


— 


Reserved 




DE11011110 


MOD 


000 


R/M 


FIADD 


Word-integer 


DE11011110 


MOD 


001 


R/M 


FIMUL 


Word-integer 



CALCULATE 2 X - 1 

CALCULATE FUNCTION Y*log 2 X 

CALCULATE TAN OF AS A RATIO 

CALCULATE ARCTAN OF 

EXTRACT EXPONENT AND SIGNIFICAND FROM S" 

DECREMENT STACK POINTER IN STATUS WORD 
INCREMENT STACK POINTER IN STATUS WORD 
MODULO DIVISION OF ST BY ST(1) 
CALCULATE VALUE OF Y*log 2 (X+1) 
CALCULATE SQUARE ROOT OF ST 

ROUND STTO INTEGER 

ADD ST(1 ) TO EXPONENT OF ST 

ADD 4-BYTE INTEGER EA TO ST 
MULTIPLY ST BY 4-BYTE INTEGER EA 
CONVERT 4-BYTE INTEGER EA, AND COMPARE W 
CONVERT 4-BYTE INTEGER EA, COMPARE WITH S 
SUBTRACT 4-BYTE INTEGER EA FROM ST 
SUBTRACT ST FROM 4-BYTE INTEGER EA 
DIVIDE ST BY 4-BYTE INTEGER EA 
DIVIDE 4-BYTE INTEGER EA BY ST 

PUSH 4-BYTE INTEGER EA ONTO ST 

STORE ROUNDED ST IN 4-BYTE INTEGER EA 
STORE ROUNDED ST IN 4-BYTE INTEGER EA, POP 

PUSH 10-BYTE EA ONTO ST 

STORE ST INTO 10-BYTE EA, POP 

ENABLE INTERRUPT 
DISABLE INTERRUPTS 
CLEAR EXCEPTIONS 
INITIALIZE PROCESSOR 



ADD 8-BYTE EA TO ST 

MULTIPLY ST BY 8-BYTE EA 

COMPARE ST WITH 8-BYTE EA 

COMPARE ST WITH 8-BYTE EA, POP STACK 

SUBTRACT 8-BYTE EA FROM ST 

SUBTRACT ST FROM 8-BYTE EA 

DIVIDE ST BY 8-BYTE EA 

DIVIDE 8-BYTE EA BY ST 

ADD STTO ELEMENT 

MULTIPLY ELEMENT BY ST 



SUBTRACT ST FROM ELEMENT 

SUBTRACT ELEMENT FROM ST 

DIVIDE ST(i) BY ST 

DIVIDE ST BY ST(i) 

PUSH 8-BYTE EA ONTO ST 

STORE ST INTO 8-BYTE EA 
STORE ST INTO 8-BYTE EA, POP 
RESTORE 8087 STATE FROM EA 

SAVE 8087 STATE TO EA 

STORE 8087 STATUS WORD TO 2-BYTE EA 

SET STACK TAG TO "EMPTY" 

STORE ST INTO ST(i) 
STORE ST INTO ST(i), POP 

ADD 2-BYTE INTEGER EA TO ST 

MULTIPLY ST BY 2-BYTE INTEGER EA 
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DE11011110 


MOD 


010 


R/M 


FICOM 


Word-integer 


DE11011110 


MOD 


011 


R/M 


FICOMP 


Word-integer 


DE11011110 


MOD 


100 


R/M 


FISUB 


Word-integer 


DE11011110 


MOD 


101 


R/M 


FISUBR 


Word-integer 


DE11011110 


MOD 


110 


R/M 


FIDIV 


Word-integer 


DE11011110 


MOD 


111 


R/M 


FIDIVR 


Word-integer 


DE11011110 


1 1 


000 


(i) 


FADDP 


ST(i),ST 


DE11011110 


1 1 


001 


(i) 


FMULP 


ST(i), ST 


DE11011110 


1 1 


010 


... 


*(5) 




DE11011110 


1 1 


011 


000 


Reserved 




DE11011110 


1 1 




011 


001 


FCOMPP 


DE11011110 


1 1 


011 


01- 


Reserved 




DE11011110 


1 1 


011 


1- 


Reserved 




DE11011110 


1 1 


100 


(i) 


FSUBRP 


ST(i),ST 


DE11011110 


1 1 


101 


(i) 


FSUBP 


ST(i),ST 


DE11011110 


1 1 


110 


(i) 


FDIVRP 


ST(i),ST 


DE11011110 


1 1 


111 


(i) 


FDIVP 


ST(i),ST 


DF 11011111 


MOD 


000 


R/M 


FILD 


Word-integer 


DF 11011111 


MOD 


001 


R/M 


Reserved 




DF11011111 


MOD 


010 


R/M 


FIST 


Word-integer 


DF 11011111 


MOD 


011 


R/M 


FISTP 


Word-integer 


DF 11011111 


MOD 


100 


R/M 


FBLD 


Packed decima 


DF 11011111 


MOD 


101 


R/M 


FILD 


Long-integer 


DF 11011111 


MOD 


110 


R/M 


FBSTP 


Packed decima 


DF 11011111 


MOD 


111 


R/M 


FISTP 


Long-integer 


DF 11011111 




000 


(i) 


*(6) 




DF 11011111 




001 


(i) 


*(7) 




DF11011111 




010 


(i) 


*(8) 




DF11011111 




011 


(i) 


*(9) 




DF11011111 




.... 


... 


Reserved 




E0 11100000 








LOOPNZ/LOOPNE DISP8 


E1 11100001 








LOOPZ/LOOPE DISP8 


E2 11100010 








LOOP 


DISP8 


E3 11100011 








JCXZ 


DISP8 


E4 11100100 








IN 


AL.PORT 


E5 11100101 








IN 


AX, PORT 


E6 11100110 








OUT 


PORT.AL 


E7 11100111 








OUT 


PORT, AX 


E8 11101000 








CALL 


DISP16 


E9 11101001 








JMP 


DISP16 


EA11101010 








JMP 


DISP16,SEG16 


EB11101010 








JMP 


DISP8 


EC11101010 








IN 


AL,DX 


ED11101010 








IN 


AX,DX 


EE 11101010 








OUT 


DX.AL 


EF 11101010 








OUT 


DX,AX 


F0 11110000 








LOCK 




F1 11110001 








(not used) 




F2 11110010 








REPNZ/REPNE 


F3 11110011 








REPZ/REPE/REP 


F4 11110100 








HLT 




F5 11110101 








CMC 




F6 11110110 


MOD 


000 


R/M 


TEST 


EA.DATA8 


F6 11110110 


MOD 


001 


R/M 


(not used) 




F6 11110110 


MOD 


010 


R/M 


NOT 


EA 


F6 11110110 


MOD 


011 


R/M 


NEG 


EA 


F6 11110110 


MOD 


100 


R/M 


MUL 


EA 


F6 11110110 


MOD 


101 


R/M 


IMUL 


EA 


F6 11110110 


MOD 


110 


R/M 


DIV 


EA 


F6 11110110 


MOD 


111 


R/M 


IDIV 


EA 


F7 11110111 


MOD 


000 


R/M 


TEST 


EA,DATA16 


F7 11110111 


MOD 


001 


R/M 


(not used) 




F7 11110111 


MOD 


010 


R/M 


NOT 


EA 


F7 11110111 


MOD 


011 


R/M 


NEG 


EA 


F7 11110111 


MOD 


100 


R/M 


MUL 


EA 


F7 11110111 


MOD 


101 


R/M 


IMUL 


EA 


F7 11110111 


MOD 


110 


R/M 


DIV 


EA 


F7 11110111 


MOD 


111 


R/M 


IDIV 


EA 


F8 11111000 








CLC 




F9 11111001 








STC 




FA11111010 








CLI 




FB11111011 








STI 





COMPARE 2-BYTE EA INTEGER WITH ST 
COMPARE 2-BYTE INTEGER EA WITH ST, POP 
SUBTRACT 2-BYTE INTEGER EA FROM ST 
SUBTRACT ST FROM 2-BYTE INTEGER EA 
DIVIDE ST BY 2-BYTE INTEGER EA 
DIVIDE 2-BYTE INTEGER EA BY ST 
ADD STTO ELEMENT, POP 
MULTIPLY ST BY ELEMENT, POP 



COMPARE ST WITH ST(1), POP TWICE 



SUBTRACT ST FROM ELEMENT, POP 
SUBTRACT ST(i) FROM ST, POP 
DIVIDE STACK ELEMENT BY ST, POP 
DIVIDE ST BY STACK ELEMENT, POP 
CONVERT 2-BYTE EA AND PUSH ONTO STACK 

ROUND ST AND STORE IN 2-BYTE INTEGER EA 
ROUND ST, STORE IN 2-BYTE INTEGER EA, POP 
LOAD BCD TO ST 

CONVERT 8-BYTE INTEGER EA AND PUSH ONTO STACK 
CONVERT ST, STORE IN 10-BYTE BCD EA, POP 
ROUND ST, STORE IN 8-BYTE INTEGER EA, POP 



LOOP (CX) TIMES WHILE NOT ZERO/NOT EQUAL 

LOOP (CX) TIMES WHILE ZERO/EQUAL 

LOOP (CX) TIMES 

JUMPON(CX)=0 

BYTE INPUT FROM PORT TO REG AL 

WORD INPUT FROM PORT TO REG AX 

BYTE OUTPUT (AL) TO PORT 

WORD OUTPUT (AX) TO PORT 

DIRECT INTRA SEGMENT CALL 

DIRECT INTRA SEGMENT JUMP 

DIRECT INTER SEGMENT JUMP 

DIRECT INTRA SEGMENT JUMP 

BYTE INPUT FROM PORT (DX) TO REG AL 

WORD INPUT FROM PORT (DX) TO REG AX 

BYTE OUTPUT (AL) TO PORT (DX) 

WORD OUTPUT (AX) TO PORT (DX) 

BUS LOCK PREFIX 

REPEAT WHILE (CX)#0 AND (ZF)=0 

REPEAT WHILE (CX)#0 AND (ZF)=1 

HALT 

COMPLEMENT CARRY FLAG 

BYTE TEST (EA) WITH DATA 

BYTE INVERT EA 

BYTE NEGATE EA 

BYTE MULTIPLY BY (EA), UNSIGNED 

BYTE MULTIPLY BY (EA), SIGNED 

BYTE DIVIDE BY (EA), UNSIGNED 

BYTE DIVIDE BY (EA), SIGNED 

WORD TEST (EA) WITH DATA 

WORD INVERT EA 

WORD NEGATE EA 

WORD MULTIPLY BY (EA), UNSIGNED 

WORD MULTIPLY BY (EA), SIGNED 

WORD DIVIDE BY (EA), UNSIGNED 

WORD DIVIDE BY (EA), SIGNED 

CLEAR CARRY FLAG 

SET CARRY FLAG 

CLEAR INTERRUPT FLAG 

SET INTERRUPT FLAG 
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FC11111100 








CLD 


FD11111101 








STD 


FE 11111110 


MOD 


000 


R/M 


INC EA 


FE 11111110 


MOD 


001 


R/M 


DEC EA 


FE11111110 


MOD 


010 


R/M 


(not used) 


FE11111110 


MOD 


011 


R/M 


(not used) 


FE 11111110 


MOD 


100 


R/M 


(not used) 


FE 11111110 


MOD 


101 


R/M 


(not used) 


FE 11111110 


MOD 


110 


R/M 


(not used) 


FE 11111110 


MOD 


111 


R/M 


(not used) 


FF 11111111 


MOD 


000 


R/M 


INC EA 


FF 11111111 


MOD 


001 


R/M 


DEC EA 


FF 11111111 


MOD 


010 


R/M 


CALL EA 


FF 11111111 


MOD 


011 


R/M 


CALL EA 


FF 11111111 


MOD 


100 


R/M 


JMP EA 


FF 11111111 


MOD 


101 


R/M 


JMP EA 


FF 11111111 


MOD 


110 


R/M 


PUSH EA 


FF 11111111 


MOD 


111 


R/M 


(not used) 



CLEAR DIRECTION FLAG 
SET DIRECTION FLAG 
BYTE INCREMENT EA 
BYTE DECREMENT EA 



WORD INCREMENT EA 
WORD DECREMENT EA 
INDIRECT INTRA SEGMENT CALL 
INDIRECT INTER SEGMENT CALL 
INDIRECT INTRA SEGMENT JUMP 
INDIRECTINTER SEGMENT JUMP 
PUSH (EA) ON STACK 



REG IS ASSIGNED ACCORDING TO THE FOLLOWING TABLE: 
16-BIT (W=1) 8-BIT (W=0) SEGMENT REG 



000 


AX 


000 


AL 


00 


ES 


001 


ex 


001 


CL 


01 


CS 


010 


DX 


010 


DL 


10 


SS 


011 


BX 


011 


BL 


11 


DS 


100 


SP 


100 


AH 






101 


BP 


101 


CH 






110 


SI 


110 


DH 






111 


Dl 


111 


BH 







EA IS COMPUTED AS FOLLOWS: (DISP8 SIGN EXTENDED TO 16 BITS) 



00 


000 


(BX) + (SI) 


DS 


00 


001 


(BX) + (DI) 


DS 


00 


010 


(BP) + (SI) 


SS 


00 


011 


(BP) + (DI) 


SS 


00 


100 


(SI) 


DS 


00 


101 


(Dl) 


DS 


00 


110 


DISP16 (DIRECT ADDRESS) 


DS 


00 


111 


(BX) 


DS 


01 


000 


(BX) + (SI) + DISP8 


DS 


01 


001 


(BX) + (DI) + DISP8 


DS 


01 


010 


(BP) + (SI) + DISP8 


SS 


01 


011 


(BP) + (DI) + DISP8 


SS 


01 


100 


(SD + DISP8 


DS 


01 


101 


(DIJ + DISP8 


DS 


01 


110 


(BP) + DISP8 


SS 


01 


111 


(BX)+DISP8 


DS 


10 


000 


(BX) + (SI) + DISP16 


DS 


10 


001 


(BX) + (DI) + DiSP16 


DS 


10 


010 


(BP) + (SI) + DISP16 


SS 


10 


011 


(BP) + (DI) + DISP16 


SS 


10 


100 


(SI) + DISP16 


DS 


10 


101 


(DI) + DISP16 


DS 


10 


110 


(BP) + DISP16 


SS 


10 


111 


(BX) + DISP16 


DS 


11 


000 


REG AX / AL 




11 


001 


REGCX /CL 




11 


010 


REGDX / DL 




11 


011 


REG BX / BL 




11 


100 


REGSP/ AH 




11 


101 


REG BP/CH 




11 


110 


REGS!/ DH 




11 


111 


REGDI / BH 





FLAGS REGISTER CONTAINS: 
X:X:X:X:(OF):(DF):(IF):(TF):(SF):(ZF):X:(AF):X:(PF):X:(CF) 
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*The marked encodings are NOT generated by the language translators. If however, 
the 8087 encounters one of these encodings in the instruction stream, it will execute 
it as follows: 

(1) FSTPST(i) 

(2) FCOMST(i) 

(3) FCOMPST(i) 

(4) FXCHST(i) 

(5) FCOMPST(i) 

(6) FFREE ST(i) and pop stack 

(7) FXCHST(i) 

(8) FSTPST(i) 

(9) FSTPST(i) 



iAPX 86/88/186 INSTRUCTION SET MATRIX 



Lo 




1 


2 


3 


4 


5 


6 


7 


ADD 
b.f.r/m 


ADD 
w.f.r/m 


ADD 
b.t.r/m 


ADD 
w.t.r/m 


ADD 
b.ia 


ADD 
w.ia 


PUSH 
ES 


POP 
ES 


ADC 
b.f.r/m 


ADC 
w.f.r/m 


ADC 
b.t.r/m 


ADC 

w.t.r/m 


ADC 

b.i 


ADC 

w.i 

AND 

w.i 


PUSH 
SS 


POP 
SS 


AND 
b.f.r/m 


AND 
w.f.r/m 


AND 
b.t.r/m 


AND 
w.t.r/m 


AND 
b.i 


SEG 

ES 


DAA 


XOR 
b.f.r/m 


XOR 
w.f.r/m 


XOR 

b.t.r/m 


XOR 
w.t.r/m 


XOR 
b.i 


XOR 

w.i 


SEG 
SS 


AAA 


INC 
AX 


INC 

cx 


INC 
DX 


INC 
BX 


INC 
SP 


INC 
BP 


INC 
SI 


INC 

Dl 


PUSH 
AX 


PUSH 

cx 


PUSH 
DX 


PUSH 
BX 


PUSH 
SP 


PUSH 
BP 


PUSH 
SI 


PUSH 
Dl 


PUSHA 


POPA 


BOUND 
r,r;m 












JO 


JNO 


JB/ 
JNAE 


JNB/ 
JAE 


JE/ 
JZ 


JNE/ 
JNZ 

test" 

w.r/m 


JBE/ 
JNA 


JNBE/ 
JA 


Immed 
b.r/m 


Immed 
w.r/m 


Immed 
b.r/m 


Immed 
is.r/m 


TEST 
b.r/m 


XCHG 
b.r/m 


XCHG 
w.r/m 


NOP 


XCHG 
CX 


XCHG 
DX 


XCHG 
BX 


XCHG "1 
SP 


XCHG 
BP 


XCHG 
SI 


XCHG 
Dl 


MOV 
m-AL 


MOV 
m-AX 


MOV 
AL->m 


MOV 
AX^m 


MOVS 
b 


MOVS 

w 


CMPS 
b 


CMPS 
w 


MOV 
i-AL 


MOV 
i-CL 


MOV 
i^DL 


MOV 
i — BL 


MOV 
i ^ AH 


MOV 
i-CH 


MOV 
i-DH 

MOV 
b.i.r/m 


MOV 
i^BH 

MOV 
w.i.r/m 

XLAT 


"y-Jy-rift . ." 

b.r/m, i 


Shift 
w.r/m. i 


RET 
(i-SP) 


RET 


LES 


L'DS 


Shift 
b 


Shift 
w 


Shift 
b.v 


Shift 
w.v 


AAM 


AAD 




LOOPNZ/ 
LOOPNE 


LOOPZ/ 
LOOPE 


LOOP 


JCXZ 


IN 
b 

HLT 


IN 
w 

CMC 


OUT 
b. 


OUT 

w 


LOCK 




REP 


REP 
Z 


Grp1 
b.r/m 


Grp1 
w.r/m 



Lo 

8 


9 


A 


B 


C 


D 


E 


F 


OR 
b.f.r/m 


OR 

w.f.r/m 


OR 
b.t.r/m 


OR 
w.t.r/m 


OR 
b.i 


OR 

w.i 


PUSH 
CS 


POP 
DS 


SBB 
b.f.r/m 


SBB 

w.f.r/m 


SBB 
b.t.r/m 


SBB 

w.t.r/m 


SBB 

b.i 


SBB 

w.i 


PUSH 
DS 


SUB 
b.f.r/m 


SUB 

w.f.r/m 


SUB 
b.t.r/m 


SUB 

w.t.r/m 


SUB 
b.i 

CMP 
b.i 

DEC 
SP 


SUB 

w.i 

CMP 
w.i 

DEC 
BP 


SEG 
CS 

SEG 
DS 

DEC 
SI 


DAS 

AAS 

DEC 
Dl 


CMP 
b.f.r/m 


CMP 
w.f.r/m 


CMP 
b.t.r/m 


CMP 
w.t.r/m 

DEC 
BX 


DEC 
AX 


DEC 
CX 


DEC 
DX 


POP 
AX 


POP 
CX 


POP 
DX 


POP 
BX 


POP 

SP i 


POP 
BP 


POP 
SI 


POP 
Dl 


PUSH 
iw 


IMUL 
r.iw.r/ni 


PUSH 
IS 


IMUL 
r.is r/m 


INS 
b 


INS 
.'■ 


OUTS 
b 


OUTS 
w 


JS 


JNS 


JP/ 
JPE 


JNP/ 
JPO 


JL/ 
JNGE 


JNL/ 
JGE 


JLE/ 
JNG 


JNLE/ 
JG 


MOV 
b.f.r/m 


MOV 
w.f.r/m 


MOV 
b.t.r/m 


MOV 
w.t.r/m 


MOV 
sr.f.r/m 


LEA 


MOV 
sr.t.r/m 


POP 

r/m 


CBW 


CWD 


CALL 
i.d 


WAIT 


PUSHF 


POPF 

LODS 

w 


SAHF 

SCAS 
b 

MOV 
i-SI 


LAHF 

SCAS 
w 

MOV 
i — Dl 

IRET 


TEST 
b,i 


TEST 
w.i 


STOS 
b 


STOS 
w 


LODS 
b 


MOV 
i — AX 


MOV 
i-CX 


MOV 
i-DX 


MOV 
i ^ BX 


MOV 
i — SP 


MOV 
i- BP 


ENTER 
Iw'.lb . 


LEAVE 


RET 
l.(i-SP) 


RET 
I 


INT 
Type 3 


INT 
(Any) 


INTO 


ESC 



ESC 
1 


ESC 
2 


ESC 
3 


ESC 
4 


ESC 

5 


ESC 
6 


ESC 
7 


CALL 
d 


JMP 

d 


JMP 
i.d 


JMP 
si.d 


IN 
v.b 


IN 
v.w 


OUT 

v.d 


OUT 

v.w 

~Grp2~" 

w.r/m 


CLC 


STC 


CLI 


STI 


CLD 


STD 


Grp2 
b.r/m 



mod . , r/m 


000 


001 


010 


011 


100 


101 


110 


111 
CMP 


Immed 


ADD 


OR 


ADC 


SBB 
RCR 


AND 
SHL/SAL 


SUB 
SHR 


XOR 


Shift 


ROL 


ROR 


RCL 


SHL/SAL 


SAR 


Grp1 


TEST 


- 


NOT 


NEG 


MUL 


IMUL 

JMP 
lid 


DIV 


IDIV 


Grp2 


INC 


DEC 


CALL 
id 


CALL 
lid 


JMP 
id 


PUSH | - : 

I I 



= 186 only instruction 



b 


= byte operation 


d 


= direct 


f 


= from CPU reg 


i 


= immediate 


ia 


- immed. toaccum. 


ib 


= immediate byte 


id 


= indirect 


IS 


= immed. byte sign ext. 


IW 


= immediate word 


I 


= long ie. intersegment 


m 


= memory 


r 


= register 


r/m 


= EA is second byte 


SI 


= short intrasegment 


sr 


= segment register 


t 


= to CPU reg 


V 


= variable 


w 


= word operation 


z 


= zero 
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APPENDIX F 
EXAMPLE MACROS 



This appendix presents some example macros. These macros are designed to support 
the writing of ASM86 routines that will be linked to other modules for the SMALL 
model of computation (see An Introduction to ASM86). The intent here is not to 
show the full power of MPL. Instead, it is to demonstrate a practical use for macros 
in a common programming situation. 

These macros could be built into an include file. If you were developing a large set of 
ASM86 modules, you could use this include file at the beginning of each of your 
modules to define a common interface between the modules (in this case SMALL). 
Similar sets of macros could be defined to support other models of computation. 

;A SET OF MACROS TO SUPPORT THE SMALL MODEL OF COMPUTATION 
;T0 BE USED AS AN INCLUDE FILE 

SNOLIST 

; TH I S MACRO WILL GENERATE A PUBLIC SEGMENT STATEMENT WITH 
;A NAME AS A PARAMETER 

%*DEF I NE (SEG (NAME) ) (%NAME SEGMENT PUBLIC ' % N A M E ' ) 

;THESE MACROS ARE USED TO GENERATE THE SEGMENT DIRECTIVES 
; FOR THE SMALL MODEL 

;C0DE SEGMENT 

%*DEFINE (CSEG) (%SEG (CODE) ) 

%*DEFINE (CEND) (CODE ENDS) 

;DATA SEGMENT 

%*DEFINE (DSEG) (%SEG(DATA)) 

%*DEF IN E (DEND) (DATA ENDS) 

; C N S T SEGMENT 

%*DEF I NE (CONSEG) ( % S E G ( CONST) ) 

%*DEF I NE (CONEND) (CONST ENDS) 

;MEM0RY SEGMENT 

%*DEFINE (MEMSEG) (MEMORY SEGMENT MEMORY 'MEMORY') 

%*DEFINE (MEMEND) (MEMORY ENDS) 

; T H I S MACRO WILL DEFINE A STACK SEGMENT. THE NUMBER OF 
;W0RDS TO RESERVE FOR THE STACK IS PASSED AS A PARAMETER. 

%*DEFINE (STACKSEG ( LENGTH) ) (STACK SEGMENT STACK 'STACK' 

DW % L E N G T H DUP (?) 



F-l 



Example Macros ASM86 



STACK ENDS) 

; THE FOLLOWING MACRO WILL GENERATE THE CODE TO INITIALIZE 
;A SEGMENT REGISTER. IT WILL USE THE AX REGISTER. 

%*DEF INE (INITCSEGREG, SEGBASE)) (MOVE AX, %SEGBASE 

MOV %SEGREG, AX) 

; THE FOLLOWING MACROS GENERATE THE PROLOGS AND EPILOGS USED 
;AT THE BEGINNING AND ENDINGS OF PROCS. 

%* DEF I NE (PROLOG) (PUSH BP 

MOV BP, SP 
) 
;NO PARAMETERS 

%*DE F I NE (EPILOG) (POP BP 

RET 
) 
; PARAMETERS TO BE POPPED OFF THE STACK 

%*DE F I NE (EPI (PARMBYTECOUNT) ) (POP BP 

RET %PARMBYTECOUNT 
) 

$ LI ST 

; G R U P DECLARATIONS FOR THE SMALL MODEL 

CGROUP GROUP CODE 

DGROUP GROUP DATA, CONST, STACK, MEMORY 

ASSUME CS : CGROUP f DS : DGROUP , SS:DGROUP, ES : DGROUP 

; END OF INCLUDE FILE 

The following is an example source file that uses these macros. 

;AN EXAMPLE SOURCE FILE USING THE SMALL MODEL MACRO 
; I N C L U D E FILE 

SINCLUDE SMALL. LIB 

% D S E G 



;some data 



% D E N D 
% C N S E G 



; constant definitions 



% C N E N D 

; reserve 10 words of stack 
%STACKSEG(10) 
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% C S E G 



APROC PROC NEAR 

% P R L G 



%EP I LOG 

APROC ENDP 

XPROC PROC NEAR 

% P R L G 



;code goes here 



;code goes here 

% EP I ( 6 ) ;pop 6 bytes of parameters 
XPROC ENDP 



% C E N D 

END 

The above source module would expand to the following form: 

;AN EXAMPLE SOURCE FILE USING THE SMALL MODEL MACRO 
; INCLUDE FILE 

$ IN C LUDE SMALL. LIB 

;A SET OF MACROS TO SUPPORT THE SMALL MODEL OF COMPUTATION 
;T0 BE USED AS AN INCLUDE FILE 

SNOLIST 

;GR0UP DECLARATIONS FOR THE SMALL MODEL 

CGROUP GROUP CODE 

DGROUP GROUP DATA, CONST, STACK, MEMORY 

ASSUME CSrCGROUP, DSrDGROUP, SS:DGR0UP, ES : DGROUP 

; END OF INCLUDE FILE 

DATA SEGMENT PUBLIC 'DATA' 

;some data 
DATA ENDS 
CONST SEGMENT PUBLIC 'CONST' 

; constant definitions 
CONST ENDS 
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; reserve 10 words of stack 

STACK SEGMENT STACK 'STACK' 

DW 10 DUP (?) 

STACK ENDS 

CODE SEGMENT PUBLIC 'CODE' 



APROC PROC NEAR 

PUSH BP 



MOV BP, SP 



POP BP 
RET 
APROC ENDP 

XPROC PROC NEAR 

PUSH BP 



;code goes here 



MOV BP, SP 



;code goes here 



POPBP ;pop6bytesof parameters 
RET 6 



XPROC ENDP 

CODE ENDS 
END 
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APPENDIX G 
EXAMPLE PROGRAMS 



In this Appendix, several sample programs are presented, each with several 
solutions. 

The first two examples illustrate transferring control to one of eight routines, 
depending on which bit of the accumulator has been set to 1 (by earlier instructions, 
not shown). 

Examples 3, 4, and 5 discuss additional methods of passing data and parameters to 
procedures, illustrating the use of both the registers and the stack for passing 
parameters. Examples 6 and 7 cover multibyte addition and subtraction. Interrupt 
procedures and timing loops are described in examples 8 and 9. Examples 10-13 
illustrate input/output control. 

The 8086 code examples given here are not optimal, and the presentation is not an 
attempt at an exhaustive and complete overview of the language. These examples are 
presented more as a gradual method of building familiarity, perhaps suggestive of 
further improvements, rather than as ideal, finished models. Some instruction usage 
is not introduced until the need for it has been suggested by the discussion of prior 
code. 



Examples 1 and 2 

Consider a program that executes one of eight routines depending on which bit of 
the accumulator is set: 

Jump to routine 1 if the accumulator holds 00000001 
Jump to routine 2 if the accumulator holds 00000010 
Jump to routine 3 if the accumulator holds 00000100 
Jump to routine 4 if the accumulator holds 00001000 
Jump to routine 5 if the accumulator holds 00010000 
Jump to routine 6 if the accumulator holds 00100000 
Jump to routine 7 if the accumulator holds 01000000 
Jump to routine 8 if the accumulator holds 10000000 

MAIN PROGRAM BRANCH TABLE JUMP 

PROGRAM ROUTINES 



(normal procedure return sequence not provided by branch table program) 

Example 1 below is a routine which transfers control to one of the eight possible pro- 
cedures depending on which bit of the accumulator is 1 . 

It moves the low-order bit of the accumulator into a flag register to find the one 
signalling the correct routine, and then transfers based on that flag. This routine 
uses seven instructions, including a test to prevent an infinite loop and an indirect 
transfer via register BX. 

Example 2 achieves the same transfer using a different technique for selecting the 
appropriate address. It shifts the high-order bit of AL, and uses register SI as an 
index into the branch table. 

Each example contains comments, and is followed by a brief explanation. 
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Example 1 



BRANCH_ADDRESSES SEGMENT 
BRANCH TABLE 1 



DW 


ROUTINE 


1 


DM 


ROUTINE 


2 


DW 


ROUTINE 


3 


DW 


ROUTINE 


4 


DW 


ROUTINE 


5 


DW 


ROUTINE 


6 


DW 


ROUTINE 


7 


DW 


ROUTINE 


8 



BRANCH_ADDRESSES ENDS 

PROCEDURE SELECT SEGMENT 



ASSUME 



MOV 
MOV 



L: 



CMP 
JE 



LEA 
SHR 

JNC 



CS:PROCEDURE_SELECT, 
DS:BRANCH_ADDRESSES 

BX,BRANCH_ADDRESSES 
DS,BX 



AL,0 

CONTINUE MAIN LINE 



; moves above segment 
; base-address into 
;segment register DS. 
;this test assures that 
;some bit of AL has been 



;set by earlier instructions to specify 
;a routine (prior insts. not shown). 



BX,BRANCH_TABLE_1 
AL, 1 

NOT YET 



JMP WORD PTR [BX] 



NOT_YET:ADD BX, TYPE B R AN C H_T A B L E_1 



JMP L 
CONTINUE_MAIN_LINE 

ROUTINEJ : 

ROUTINE 2: 



BX set to Location holding 

address of first routine. 

puts Least-significant bit 

of AL i nto the carry f Lag 

(CF) . 

if CF = 0, the ON bit 

in AL has not yet 

been found. 

if CF = 1, then cont roL 

i s t ransf erred (see 

explanation below). 

i f no t ransf er, then 
the bit that is ON has 
not yet been found, so 
BX i s set to poi nt to 
the next entry in the 
address-table, by adding 2 
j ump to L to shift 
and retest 
we reach here on ly 
if no bit was set to 
i ndi cate a desi red 
routine 
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ROUTINE 3: 



PROCEDURE_SELECT ENDS 

The line after "L:", JNC NOT_YET, reads "jump if no carry", which means 
jump if CF = 0. This will skip over the next line's transfer if the "1" bit, signalling 
the desired procedure, has not yet appeared. If it has been found, CF will be 1 and 
this conditional jump JNC will be skipped. The appropriate procedure is then 
reached by the indirect jump instruction JMP WORD PTR [BX]. 

A jump is always to an address in the code segment, i.e., relative to CS. The offset 
defining that address in the code segment is not given explicitly here. Instead, an 
indirect JMP is used, with [BX] given as a pointer to the memory location where that 
offset is stored. 

Register BX as used here within square brackets automatically refers to the contents 
of a location in the data segment. The contents of that location are the desired offset 
for the jump. In other words, the Instruction Pointer is replaced by the contents of a 
location in the data segment, whose offset is in BX. The next instruction, ADD BX, 
TYPE BRANCH__TABLE_1, adds 2 to BX, the index into the branch table. This 
causes BX to point to the next word of the table. The contents of that word are the 
offset of the "next" routine, again in the code segment. 



Example 2: 

BRANCH_ADDRESSES SEGMENT 
BRANCH TABLE 1 



DW 
DW 
DW 
DW 
DW 
DW 
DW 
DW 



ROUTINEJ 
R0UTINE_2 
R0UTINE_3 
R0UTINE_4 
R0UTINE_5 
R0UTINE_6 
R0UTINE_7 
ROUTINE 8 



BRANCH_ADDRESSES ENDS 
PROCEDURE SELECT SEGMENT 



L: 



ASSUME CS:PROCEDURE_SELECT, 
DS:BRANCH_ADDRESSES 

MOV BX,BRANCH_ADDRESSES 
MOV DS,BX 

LEA BX,BRANCH_TABLE_1 

MOV SI,7*TYPE BRANCH_TABLE_1 

MOV CX,8 
SHL AL,1 
JNC NOT YET 



JMP 



WORD PTR [BXHSI] 



base-address of 
segment containing 
lists 

base-address of List 
of branch addresses 
points initially to 
last such ent ry 
in list 

loop-counter allowing 
8 shifts maximum 
shifts high-order 
A L bit into C F 
if CF = 0, routine 
represented by that 
bi t not desi red 
if CF = 1, transfer 
to procedure 
represented by most 
recent bit tested 
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N0T_YET: SUB SI, TYPE BR AN C H_T AB LE_1 



LOOP L 



CONTINUE MAIN LINE: 



ROUTINE 1 : 



adjust index register 

to point to ' ' next ' ' 

branch-address 

decrement CX, if 

CX > 0, t ransf er to 

L so as to shift 

AL and ret est 

we reach here only 

if no bit was set 

to indicate a 

des i red rout i ne 



ROUTINE 2: 



ROUTINE 3: 



PROCEDURE SELECT ENDS 



In Example 2 several elements have changed, though the net result is the same. 
Instead of being incremented, BX stays constant, pointing to the beginning of the 
list of branch addresses. SI is used as an index (subscript) within that list. 

The number of shifts is controlled by the count register CX, which the LOOP 
instruction automatically decrements after each iteration. The accumulator AL is 
searched from its most-significant-bit using the shift-left instruction (SHL) instead 
of SHR. This accounts for the initialization of SI to 14, pointing initially to the last 
branch-address in the list, 14 bytes past the base-address in BX. SI is subsequently 
decremented in each iteration just as Example 1 's BX was incremented. 

The instruction JMP WORD PTR [BX][SI] uses the sum of BX and SI just as Exam- 
ple 1 used BX alone. That is, the sum gives the offset of a word in the data segment, 
and the contents of that word replaces the IP. The next instruction executed is thus 
the one whose code-segment offset was stored in the branch table. 

If more than 1 bit were set in AL, these two examples would select different routines 
due to selecting the rightmost or leftmost such bit. 



Transferring Data to Procedures 

The data on which a procedure performs its operations may be made available in 
registers or memory locations. In many applications, however, reserving registers 
for this purpose can be inconvenient to the system flow of control and uneconomical 
in execution time, requiring frequent register saves and restores. 

Reserving memory, on the other hand, can be uneconomical of space, especially if 
such data is needed only temporarily. It is often preferable to use and reuse a special 
area called a stack, storing and deleting interim data and parameters as needed. 

Regardless of the method used to pass data to procedures, a stack will be necessary 
and useful. The CALL instruction uses the stack to save the return address. The 
RET instruction expects the return address to be on the stack. The stack is also 
usually used to save the caller's register values at the beginning of a procedure. 
Then, just before the procedure returns to the caller, these values can be restored. 
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Example 3 shows the use of memory to pass parameters. Registers are used for this 
in Example 4. Example 5 uses a stack. 

One way to use memory to pass data is to place the required elements (called a 
parameter list) in some data area. You then pass the first address of this area to the 
procedure. 

For example, the following procedure, ADSUB, expects the address of a three-byte 
parameter list in the SI register. It adds the first and second bytes of the list, and 
stores the result in the third byte of the list. 

The first time ADSUB is called, at label CALL1, it loads the accumulator from 
PLIST, adds the value from the next byte and stores the result in PLIST+2. Return 
is then made to the instruction at RET1 . 

AFTER first call to ADSUB: 



SI 




06 








08 






14 









The second time ADSUB is called, at label CALL2, the prior instruction has caused 
the SI register to point to the parameter list LIST2. The accumulator is loaded with 
10, 35 is added, and the sum is stored at LIST2 + 2. Return is then made to the 
instruction at RET2. 



Example 3: 






PARAMS 


SEGMENT 




PLIST 




DB 


6 






DB 


8 






DB 


r ) 


LIST2 




DB 


10 






DB 


3 5 






DB 


? 



PARAMS ENDS 

STACK SEGMENT 

DW 4 DUP (?) 
STACKJTOP LABEL WORD 
STACK ENDS 



ADDING SEGMENT 
ASSUME CS : ADDING , 



START: 



MOV 
MOV 
MOV 
MOV 



DS:PARAMS, SS : STACK 

AX, PARAMS 
DS,AX 
AX, STACK 
SS r AX 



; i n i t i a I i z e D S 
; i n i t i a I i z e S S 
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CALL1 
RET1 : 



MOV 
MOV 
CALL 



SP, OFFSET 
SI, OFFSET 
ADSUB 



STACK 
PLIST 



TOP 



initialize S P 



CALL2 
RET2 



ADSUB 



ADSUB 



LEA 
CALL 



PROC 

MOV 

ADD 

MOV 

RET 

EN DP 



SI,LIST2 
ADSUB 



AL, [SI] 
AL f CSI+1] 
[S 1 + 2] , AL 



;get 1st parameter 
;add 2nd parameter 
; store result in 
;3rd parameter 



ADDING 



ENDS 

END START 



The instructions just prior to each CALL load the SI register with the offset of the 
first parameter to be added. The MOV statement prior to CALL1 makes use of the 
OFFSET operator (discussed in Chapter 4). If this operator were omitted, SI would 
receive the contents of PLIST instead of its offset. The LEA instruction prior to 
CALL2 automatically puts the offset of its source (2nd operand) into the register 
destination (1st operand). The MOV statement is more efficient, but may only be 
used if just the offset is being loaded into the register. If the address involves an 
indexing register (e.g., PLIST [SI + 1]), then the LEA should be used, since this will 
add the contents of the SI, 1, and the offset of PLIST, putting the sum in the 
destination register. 



A More General Solution 

The approach used in Example 3 has its limitations, however. As coded, ADSUB 
will process a list of two and only two numbers to be added, and they must be con- 
tiguous in memory. Suppose you wanted a subroutine (GENAD) which would add 
an array containing an arbitrary number of bytes, located anywhere in memory, and 
leave the sum in the accumulator. 

CALL to GENAD: 



QENAD: 



BX 




PARM1 




PARM2 




cx= 

COUNT 


PARM3 






PARM4 



G-6 



ASM86 



Example Programs 



Example 4 below shows how this process can be written in ASM86. GENAD returns 
the sum in the accumulator. It receives the address of the array in the BX register, 
and the number of array elements in CX. 



Example 4: 



INITIAL 

RESULT 

PARM 



PARAMETERS 
DB 
DB 6, 



SEGMENT 



82, 13, 16 



INITIAL PARAMETERS 



ENDS 



GENERAL_PROCEDURES SEGMENT 

ASSUME CS rgenera l_procedures DS : i ni t i a L_parameters 



The procedure is placed first, to avoid forward 
referencing the FAR procedure GENAD. Note that the 
program ; start address is after the procedure, at label 
"START2. 



GENAD 



IN IT : 



MORE? 



PROC FAR 
PUSH SI 



I0V AL, 
I0V SI, 



ADD AL, [BXHSI] 

INC SI 
LOOP MORE? 



GENAD 



POP 
RET 



ENDP 



SI 



save current value of SI on the 
stack (discussed below), so that 
this routine can use this 
register freely, restoring its 
original contents just prior 
to returni ng cont ro I to 
calling rout i ne . 
initialize AL to receive sum. 
initialize SI to point to first 
array element 

add next array element to sum. 
BX points to the start of the 
array, and SI selects an element 
of the array . 

have S I i ndex the next 

a r ray e I ement . 

continue looping until CX is 

zero (all array elements have 

been added into AL) 

; restore original contents of SI. 

; transfer to instruction 

; immediately following CALL. 



Program execution starts here (due to the label "start" 
named on the END directive below). Point DS to the 
INITIAL_PARAMETERS segment, and call GENAD with the array 
PARM. 
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START: MOV AX, IN I T I A L_P A R AM E T E R S 

MOV DS, AX 

MOV CX, SIZE PARM ; number of elements is 

; passed in CX 

MOV BX, OFFSET PARM ;address of array PARM is 

jpassed in BX. 

CALL GENAD 

MOV RESULT, AL ;Sum is returned in AL 

HLT ;******* end of program ******* 

6ENERAL_PROCEDURES ENDS 

END START 

In GENAD, the first action is to save (PUSH) onto the stack the current value of SI 
before using it. Just before the RETurn, this value is restored (via POP). Thus this 
procedure does not destroy the status of registers (except AL and CX) possibly relied 
upon by the calling routine. Stacks are discussed in Chapter 4. Further examples 
appear below. 

The routine does not explicitly save the value of CS because the CALL and RETurn 
save CS on the stack and restore it automatically. The accumulator AL is here 
expected to be usable without saving its pre-CALL contents. Using AL, the sum is 
modulo 256. 

The FAR type declaration on the PROC statement forces the use of "long" CALLs 
to and RETurns from this procedure. This means the procedure is not expected to be 
in the same segment as all of the CALLs to it. In a "long" CALL the contents of CS 
are PUSHed onto the stack first, then the IP is PUSHed onto the stack. (This allows 
an eventual return to the next sequential instruction.) Control is then transferred to 
the procedure by first moving into CS the segment base address for the procedure, 
and then replacing the contents of IP with the offset of the procedure in that seg- 
ment. A "long" RETurn reverses this process by POPping the former IP contents 
back off the stack into IP, and then POPping the former CS contents off the stack 
back into CS. 

Within the inner body of GENAD, the statement 

MOV AL,0 

initializes the sum to zero. The statement 

MOV SI,0 

initializes SI to zero, to index the first element of the passed array. 

The first statement in the loop 

ADD AL, [BX] [SI] 

adds the array element indexed by SI into the sum in the accumulator (recall that the 
BX register points to the parameter array). In the next statement (INC SI), the array 
index in SI is incremented to point to the next array element. The last statement in 
the loop 

LOOP MORE? 

executes the loop repeatedly until the count in CX (passed in as a parameter) is 
exhausted. 
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Using a Stack 

Passing parameters on the stack offers different advantages than passing them in 
registers. Passing parameters in registers is faster, but more complicated. The con- 
ventions as to which parameter should end up in which register can be confusing, 
especially if there are many procedures. 

For parameters passed on the stack, the convention need only specify the order they 
should be pushed onto the stack. High level language compilers (e.g., PL/M-86) 
generate code which passes parameters on the stack. Therefore, any procedure 
which expects its parameters on the stack is callable from PL/M (see Appendix B of 
the Operator's Guide for more details). The 8086 also offers special instructions to 
facilitate using the stack for passing parameters. The RET instruction has an 
optional byte count (e.g., RET 4), which says how many bytes should be popped off 
the stack in addition to the return address. This makes returning from procedures 
very easy. Moreover, since the BP indexing-register uses the SS segment by default, 
it is very economical to use BP to reference data near the top of the stack. 

Use of stacks may require some further introduction. A stack segment is expected to 
be used relative to the contents of the stack-segment register SS, just as a code seg- 
ment uses CS and data segments use DS or ES. The stack segment below is defined 
for use in this discussion and the examples. 

PARAMS_PASS SEGMENT STACK 

DW 12 DUP (0) 
LAST_W0RD LABEL WORD 
PARAMS_PASS ENDS 

Four instructions use a stack in predefined ways: PUSH, CALL, POP, and 
RETurn. They automatically use the stack pointer SP as an offset to the segment- 
base-address in SS. One of your first actions in a module which will use a stack must 
be to initialize SS and SP. e.g., 

MOV AX,PARAMS_PASS 

MOV SS f AX 

MOV SP, OFFSET LAST_W0RD 

This use of LAST WORD is critically important due to the built-in actions of the 

four instructions named above. 

The first two, PUSH and CALL, store additional words on the stack by decrement- 
ing SP by 2. Thus the stack "grows downward" from the last word in the stack seg- 
ment toward the segment-base-address lower in memory. Each successive address 
used for new data on the stack is a lower number. The location pointed to by SP is 
called the Top Of Stack (TOS). When a word is stored on the stack, e.g., by the 
instruction 

PUSH S0URCE_.DATA 

SP is decremented by 2 and the source data is moved onto the stack at the new offset 
now in SP. As described above in Example 4, CALL implicitly uses PUSH before 
transferring control to a procedure. 

The instruction 

POP DESTINATION 

takes the word at the "top-of-stack", i.e., pointed at by SP, and moves that word 
into the specified destination. POP also then automatically adds 2 to SP. This 
causes SP to point to the next higher-addressed word in the stack segment, farther 
from the segment's base-address. The figures accompanying the examples below 
show the expansion and contraction of a stack. 
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Example 5 below illustrates the use of a stack to pass the number of byte parameters 
plus the address of the first one. For this example all the parameters are expected in 
successive bytes after that one. 



Supplying the Number of Parameters and the First Address, 
On the Stack 



Example 5: 

params_pass 

last_word 

params_pass 
data items 



SEGMENT STACK 
DW 12 DUP 

LABEL WORD 



ENDS 
SEGMENT 



(?) 



reserve 12 words of 
stack space 
Last_word is the 
offset of top of 
stack 



first DB 11, 22, 33, 44, 55, 

second DB 4, 5, 6 

third DB 94, 88 

result DX ? 

data items ENDS 



66 



st k_usage_xmpl 



genaddr PROC 



adder : 



MOV 

ADD 
ADC 
INC 

LOOP 



POP 

POP 

POP 
RET 



SEGMENT 

ASSUME CS: st k_usage_xmp I , DS: data_items, SS:params_| 



FAR 



PUSH 


BP 




PUSH 


BP, 


SP 


PUSH 


BX 




PUSH 


CX 




MOV 


CX, 


[BP + 8] 


MOV 


BX, 


[BP + 101 



AX, 

AL, [BX] 
AH, 
BX 

adder 



CX 

BX 

BP 
4 



save old copy of BP 

move tos to BP (see 

figure 4) 

save BX, so ok to use BX in 

genaddr 

save CX, so ok to use CX in 

genaddr (figure 5) 

get count of number of bytes 

i n array 

get address of array of 

bytes 

AX := 0. AX holds running 

sum in adder loop. 

add in the first byte 

and add any carry into AH. 

point to next byte to be 

added in. 

CX := CX - 1 ;IF CX <> THEN 

GOTO ADDER; 

The registers must be 
restored in the 
reverse order they were 
pushed . 

; return, popping off the 2 
;W0RD parameters 
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genaddr ENDP 

stk_usage_xmp I ENDS 

caller SEGMENT 

ASSUME CS: cal ler, DS 

start: MOV AX, data_items 

MOV DS, AX 

MOV AX, params_pass 

MOV SS, AX 

MOV SP, OFFSET last word 



MOV AX, OFFSET first 

PUSH AX 

MOV AX, SIZE first 

PUSH AX 

CALL genaddr 



MOV 



resu It , AX 



data_items, SS: params_pass 

paragraph number of 
data segment to AX 
and then to DS . 
paragraph number of 
stack segment to AX 
and then to SS 
offset of the 
stack_top to the SP 

offset of f i rst to 
AX 

then onto the stack 
number of bytes in 
f i rst array to AX 
then onto the stack 
Cal I the far 
procedure 



MOV AX, OFFSET second 

PUSH AX 

MOV AX, SIZE second 

PUSH AX 

CALL genaddr 

MOV result, AX 



;same as above except 
; doing second 



MOV AX, OFFSET third 

PUSH AX 

MOV AX, SIZE third 

PUSH AX 

CALL. genaddr 

MOV result, AX 



;same as above except 
; doing third 



caller 



HLT 



ENDS 

END start 



To indicate why each register was saved, the above code has each PUSH placed just 
prior to the first local use of that register. Earlier examples clustered those PUSHes 
at the top of the routine, just as the POPs appear (in reverse order) at the end. This 
makes it easy to see the proper order of saving and restoring. In either case you must 
consider carefully where the parameters are relative to the pointer you are using, 
e.g., BP. Making your own diagrams can help. 
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Note that the RET instruction of "genaddr" is a RET 4; the two parameters are 
popped off the stack as the RETurn is executed. Without the 4, this 12 word stack 

named "P ARAMS PASS" could only be used three times. The fourth call would 

cause two words outside that segment to be clobbered. 

This is why: prior to each call the parameter words are pushed onto the stack. Then 
each call uses two words of the stack to store the return address. Each execution of 
the procedure pushes three more words onto the stack to preserve register values. 
These last five words are popped off by the procedure's end and return, but those 
first two parameters would remain. 



Multibyte Addition and Subtraction 

The carry flag and the ADC (add with carry) instructions may be used to add 
unsigned data quantities of arbitrary length. Consider the following addition of two 
three-byte unsigned hexadecimal numbers: 

32AF8A 
+ 84BA90 



B76A1A 



To perform this addition, you can use ADD or ADC to add the low-order byte of 
each number. ADD sets the carry flag for use in subsequent instructions, but does 
not include the carry flag in the addition. 

Step 3 Step 2 Step 1 



32 


AF 


8A 


84 


BA 


90 


B7 


6A 


1A 


carry=1 


carry=1 





The routine below performs this multibyte addition, making these assumptions: 

The numbers to be added are stored from low-order byte to high-order byte begin- 
ning at memory locations FIRST and SECOND, respectively. 

The result will be stored from low-order byte to high-order byte beginning at 
memory location FIRST, replacing the original contents of these locations. 



MEMORY AFTER 

FIRST SECOND 

1A 90 

6A BA 

B7 84 

The routine uses an ADC instruction to add the low-order bytes of the operands. 
This could cause the result to be high by one if the carry flag were left set by some 
previous instruction. This routine avoids the problem by clearing the carry flag with 
the CLC instruction just before LOOPER. 

Since none of the instructions in the program loop affect the carry flag except ADC, 
the addition with carry will proceed correctly. 



MEMORY BEFORE 








FIRST + 


SECOND 


+ 


CF 




8A + 


90 


+ 


= 


1A 


AF + 


BA 


+ 


1 = 


6A 


32 + 


84 


+ 


1 = 


B7 
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MULTI_TW0 SEGMENT 

ASSUME CS:MULTI_TWO, 

& DS:ADD_DATA_2 

START: MOV AX , ADD_DATA_2 
MOV DS,AX 



Longer and stores 
the sma Iter number 
rs do have a byte 



MOV 


AX, 


NUM2 


LEA 


BX, 


SECOND 


LEA 


BP, 


FIRST 


CMP 


AX, 


NUM1 


J6E 


NUM2 


BIGGER 



The routine determines which number is 

the result there. The size in bytes of 

controls L00P1 , i.e., where both numbe 

of data to be added. 

The difference in size controls L00P2, which is needed if 

there is a final carry . 

Initially assume NUM2 

la rger , and 

give BX address of 

longer number, 

BP address of shorter 

number . 



Check assumption, 
continue with values 
as they are unless N2 
> N1 . 

Switch NUM2 and NUM1 , 
exchang i ng 

through AL NUM2 now < 
NUM1 . 

Must a I so now switch 
addresses referred to, 
so that number of 
bytes still 
corresponds with 
correct number, 
and sum goes 
to longer place. 



XCHG AX, NUM1 
XCHG AX, NUM2 

XCHG BX, BP 



NUM2_B IGGER :M0V CX, NUM2 
SUB CX, NUM1 



MOV NUM2, CX 
MOV CX, NUM1 



CLC 



L00P1 : 



MOV SI, 



MOV AL, DS: EBP] [SI] 



ADC [BX] [SI, AL 



;NUM2 now gets 
; difference 



of sizes. Use sma I ler 

number of bytes for 

cent ra I add . 

Clear carry of 

possi b le prior 

setting 

Initialize i ndex to 

bytes of addends. Then 

S I = S I + 1 . 

Get byte of shorter 

number . 

Add it to re levant 
byte of 
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L00P2: 



INC SI 

LOOP L00P1 

MOV CX, NUM2 

JNB DONE 

ADC BYTE PTR CBX] CSI],0 

INC SI 

LOOP LOOP2 



Longer number. Then 
S I =S I +1 



; Number of bytes yet 
; unused in Longer 
; number . 

If no carry, C F = , 

then done. 

Add carry to remaining 

bytes 

of Longer number. Then 

S I = S 1 + 1 . 



DONE: 



MULTI TWO 



ENDS 

END START 



With some additional instructions, this same routine will do arithmetic for packed- 
decimal numbers. Packed-decimal means the 8 bits of each byte are interpreted as 2 
decimal digits, e.g., 01 10011 IB would mean 67 decimal instead of 67 hexadecimal 
(103 decimal). 

Below is the core of an 8086 routine to do decimal subtraction for packed-decimal 
numbers. 



Example 7: 



MORE? 



MOV 
MOV 
CLC 
MOV 
SBB 
DAS 
MOV 
INC 



SI, 

CX, NUMBYTES 

AL, FIRST [SI] 
AL, SECOND ESI] 

SECOND [SI], AL 
SI 



LOOP MORE? 



Interrupt Procedures 

Example 8: 

The foLLowing illustrates the use of interrupt procedures 
for the 8086. The code sets up six interrupt procedures 
for a hypothetical 8086 system invoLved in some type of 
process controL application. There are 4 sensing devices 
and two alarm devices, each of which can supply external 
interrupts to the 8086. The different interrupt-handling 
procedures shown below are arbitrary, that is, the events 
and responses described are not inherent in the 8086 but 
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; rather in this hypothetical control application. The 
jprocedures merely illustrate the diverse possibilities 
;for handling situations of varying importance and 
; u r g e n c y . 

ASSUME CS:INTERRUPT_PROCEDURES, DS:DATA_VAR 



DEVICEJ 
DEVICE_2 
DEVI CE_3 
DEVICE 4 



PORT 
PORT 
PORT 
PORT 



WARN ING_LIGHTS 

CONTROL 1 



EQl) 0F000H 

EQU 0F002H 

EQU 0F004H 

EQU 0F006H 

EQU 0E000H 

EQU 0E008H 

EXTRN CONVERT_VALUE : FAR 

;Positioning this EXTRN here indicates 
; that CONVERT_VALUE is outside of 
;all segments in this module. 



INTERRUPT PROC TABLE SEGMENT BYTE AT 



ORG 08H 



DD 



ALARM 1 



One 64 
that h 
addres 
to e a c 
double 
addres 
is s t o 
addres 
poi nt 
The fi 
reserv 
8086 U 
32 mus 
i nterr 



K are 

and le 
s zer 
h i nt 
word 
s f or 
red a 
ses a 
to th 
rst 3 
ed by 
ser ' s 
t the 
upt v 



a of memo 

i n t e r r u p 

o . The ad 

errupt ty 

whose ad 

the hand 

s the con 

re also c 

e respect 

2 i n t e r r u 

INTEL fo 

Manual f 

refore us 

ector . 



ry co 
ts. T 
dress 
pe i s 
dress 
ler o 
tents 
ailed 
i ve p 
pt ty 
r pre 
or mo 
e loc 



nta i n 

his a 

f o r 

expe 

i s 4 

f non 

of a 

i nt e 

roced 

pes ( 

sent 

re de 

at i on 



; non-maskable interrupt 
type 2 

s pointers to the routines 
rea begins at absolute 
the routine appropriate 
cted as the contents of the 

times that type. Thus the 
-maskab le-i nter rupt type 2 
bsolute location 8. These 
rrupt vectors since they 
ures . 

0-31 ) are def i ned or 
and future uses. (See the 
tail.) User-interrupt type 

128 (=80H) for its 



ORG 08H 



DD 
DD 
DD 
DD 
DD 



ALARM_2 
DEVICEJ 
DEV I CE_2 
DEV I CE_3 

DEVICE 4 



INTERRUPT 
INTERRUPT 
INTERRUPT 
INTERRUPT 
INTERRUPT 



TYPE 
TYPE 
TYPE 
TYPE 
TYPE 



32 
33 
34 
35 
36 



INTERRUPT PROC TABLE 



ENDS 



DATA_VAR 
EXTRN 



SEGMENT 



PUBLIC 



EXTRN 



INPUT 
INPUT 
ALARM 



1_VAL. : BYTE 
"3_VAL: BYTE 
"FLAG : BYTE , 



0UTPUT_2_VAL: BYTE 
INPUT_4_VAL: BYTE 
INPUT F LAG : BYTE 



The names above are used by 1 or more of the procedures 
below, but the location or value referred to is located 
(defined) in a different module. These EXTeRNal 
references are resolved when the modules are linked 
together, meaning all addresses will then be known. 
Declaring these EXTRNs here indicates what segment they 
are i n . 



DATA VAR ENDS 
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;The names below are defined Later in this module. The 
; PUBLIC directive makes their addresses available for 
; other modu les to use . 



PUBLIC 



ALARMJ , 
DEVICE 4 



ALARM_2, DEVICEJ, DEVICE_2, DEVICE_3 f 



INTERRUPT_PROCEDURES SEGMENT 

ALARMJ PROC FAR 

The routine for type 2, ' ' A LARM_1 ' ' is the most drastic 
because this interrupt is intended to signal disastrous 
conditions such as power failure. It is non-maskable, 
i.e., it cannot be inhibited by the CLear Interrupts 
(CLI) i nst ruct i on. 



ALARMJ 
ALARM 2 



MOV 
MOV 
OUT 
MOV 
MOV 
OUT 
HLT 



DX, WARN ING_LIGHTS 

AL, OFFH 

DX,AL 

DX, CONTROLJ 

AL, 38H 

DX, AL 



ENDP 
PROC 



turn on all lights 

turn off 

mac hi ne 

stop a 1 1 processi ng 



FAR 



PUSH 

PUSH 

MOV 

MOV 

OUT 



POP 
IRET 



DX 
AX 
DX, 
AL, 1 
OX , AL 



WARNING LIGHTS 



MOV ALARM_FLAG, OFFH 
POP AX 



DX 



turn on warning light #1 
to warn operator of device 

set alarm flag to inhibit 
later processes which may 
now be dangerous 

return from interrupt: 
this restores t he f lags 
and returns control 
the interrupted 
i nst ruct i on st ream 



ALARM_2 ENDP 
DEVICE 1 PROC 



PUSH DX 

PUSH AX 

MOV DX, DEVICE_1_PORT 

IN AL, DX 

MOV INPUT_1_VAL, AL 



MOV 



INPUT FLAG, 2 



;get input byte from 
;device_ store value 

; thi s may alert another 
; routine or device that 
;this interrupt and input 
.•occurred 
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DEVICEJ 
DEVICE 2 



POP AX 
POP DX 
IRET 

ENDP 
PROC 



PUSH 
PUSH 



MOV 
MOV 
OUT 
POP 
POP 
IRET 



DX 
AX 



;when this interrupt-type 
; occurs, the action necessary 
;is to notify devi ce_2_port 
; o f the event 



AL, 0UTPUT_2_VAL ;get value, to output 

DX, DEVICE_2_P0RT ;to devi ce_2_port 

DX, AL 

AX 

DX 



DEVI CE_2 
DEVICE 3 



ENDP 

PROC 
PUSH DX 



PUSH 

MOV 

IN 

AND 

MOV 

POP 

POP 
IRET 



AX 
DX 



DEVICE 3 PORT 



AL, DX 

AL,0FH 

INPUT_3_VAL, AL 
AX 

DX 



DEV I CE_3 ENDP 
DEVICE 4 PROC 



PORT 



PUSH DX 

PUSH CX 

PUSH AX 

MOV DX, DEVI CE_4. 

IN AL,DX 

MOV CL, AL 



CALL CONVERTJ/ALUE 
MOV INPUT_4_VAL, AL 



POP AX 

POP CX 

POP DX 
IRET 

DEV ICE_4 ENDP 
INTERRUPT PROCEDURES 



;when a device_3 interrupt 
; occurs only the Lower byte 
; a t the port is of value 

;mask off top four bits 
,* store value for use 
;by later routines 
;in another module 



a devi ce_4 interrupt 
provides a value which 
needs immediate 
conversion by another 
procedurebef ore this 
interrupt-handler can allow 
it to be used at input_4_val 

converts i nput value in 
CL to new result in AL 
and saves that resu It in 
i nput_4_va I 



ENDS 



END 
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Timing Loop 

Example 9: 

This example is a procedure for supplying timing loops 
for a program. The amount of time delayed is set by a 
byte parameter passed in the AL register, with the amount 
of time = PARAM * 100 microseconds. This is assuming that 
the 8086 is running at 8 MHZ. 

ASSUME CS:TIMER SEG 



TIMER_SEG SEGMENT 

TIME PROC 

DELAY_L00P: MOV CL, 78H ;shift count for supplying 

SHR CL,CL ; proper delay via SHR countdown 

DEC AL ; decrement timer count 

JNZ DELAY LOOP 



TIME 
TIMER 



SEG 



RET 
ENDP 
ENDS 
END 



I/O Routines 

The examples below (10-13) illustrate the type of procedures used by the SDK86 
Serial I/O Monitor to communicate with the keyboard and display units during 
execution. 

The first, SIO CHAR RDY, tests whether an input character is awaiting 

processing. 

The second SIO_OUT_CHAR, outputs a character unless SIO_CHAR_RDY 
reports an input character is there, which is handled first. 

The third, SIO OUT STRING, puts out an entire string of characters, e.g., a 

page heading, using SIO OUT CHAR for each output byte. 



Example 10: 

SIO CHAR RDY PROC NEAR 



PUSH BP 

MOV BP, SP 

MOV DX, 0FFF2H 

IN AL,DX 

TEST AL, 2H 

JNZ READY 

MOV AL, 

POP BP 
RET 



;save old value 



address of status port to DX 
input from status port 
is read-data-ready line=1, 
i.e., character pending? 
if so, return TRUE 

;if not, return FALSE: AL=0 
; restore old value 
;done, no char waiting 
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READY: 



MOV 


AL, 


POP 


BP 


RET 





OFFH ;return TRUE 
; restore old 
;done, char 



AL = a 1 1 ones 
va lue 
s waiting 



SIO CHAR RDY 



ENDP 



Example 11: 

The above procedure also appears in this example, which introduces names for some 
of the specific numbers used above, and for some that will be used in later examples. 
These names can make it easier to read the procedure and understand what is going 
on, or at least what is intended. 

The example also uses BX and reorders the code to save a few bytes. 



TRUE 

FALSE 

STATUS_PORT 

DATA_P0RT 

ASC I I_MASK 

C0NTR0L_S 

C0NTR0L_Q 

CARR RET 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



OFFH 

OH 

0FFF2H 

OFFFOH 

7FH 

13H 

11H 

ODH 



SIO CHAR RDY2 PROC 



NEAR 



RESULT: 



PUSH 

MOV 

MOV 

IN 

TEST 

JNZ 

MOV 



MOV 
POP 
RET 



BX 

BL, TRUE 

DX, STATUS_PORT 

AL,DX 

AL, 2H 

RESULT 

BL, FALSE 



AL, 
BX 



BL 



save o Id BX va lue 
prepare for one result 
check the facts 
char waiting??? 
if 2nd bit ON, char is 
waiting hence skip over 
FALSE set-up here if 2nd 
bi t was off , hence no 
char waiting 
AL recei ves whichever 
restore o Id BX va lue 



SIO CHAR RDY2 ENDP 



Example 12: 

SIO OUT CHAR 



PROC 



NEAR 



;This routine outputs an input parameter to the USART 

; output port when UART is ready for output transmit 

; buffer empty. The input to this routine is on the stack 



PUSH BP 

MOV BP, SIP 

CALL SI0_CHAR 

RCR AL, 1 

JNB OUTPUT 



RDY ; keyboard input pending? 

; p u t low-byte into CF to test 
; i f no input char waiting from 
; keyboard, go to output loop 
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CHECK: 



MOV DX f DATA_P0RT 
IN AL ( DX 

AND AL, ASC I I_MASK 

MOV CHAR, AL 

CMP AL # CONTROL_S 

JNZ OUTPUT 



CMP CHAR, CONTROL_Q 
JZ OUTPUT 



CALL SIO_CHAR 
RCR AL, 1 
JNB CHECK 



RDY 



MOV DX, DATA_PORT 

IN AL,DX 

AND AL, ASC I I_MASK 

MOV CHAR, AL 

CMP AL, CARR_RET 

JNZ CHECK 

JMP NEXTCOMMAND 



char waiting: get i t 

char to AL from that port 

strip off high bit, Leavi ng 

ASCII code 

save char 

is char cont ro l-S? 

if this halt-display signal 

is notrec'd, continue 

output at OUTPUT 

i f cont ro l-S rec * d, must 

await its release 

Control-Q received? 

if this continuation-signal 

rec ' d, to do next output 

keep checking for new keyboard 

input, looping from CHECK 

to here until input waiting 

; get waiting character 



;if char=carriage-return, 
;skip this instruction, which 
; loops to await control-Q, and 
;go to NEXTCOMMAND 



OUTPUT: 

CONTINUE: 

MOV 
IN 

TEST 
JZ 

MOV 
MOV 
OUT 

POP 
RET 



DX, STATUS_PORT 

AL,DX 

AL, 1 

OUTPUT 



DX 
AL 
DX 

BP 
2 



DATA_PORT 
[BP] + 4 
AL 



loop unt i I status port 
and transmit line indicate 
ready to put out character 



; output port address to DX 

jcharacter from stack to AL 

; output character in AL through 

; restore original BP value 
; repositions SP behind prior 
; parameter 



SIO OUT CHAR 



ENDP 



Example 13: 

S IO_OUT_STR ING PROC NEAR 

; Outputs a string stored in the ' 'extra'' segment (uses ES 
;as base), the string being pointed to by a 2-word pointer 
;on the stack 



PUSH BP 
MOV BP, SP 
MOV SI,0 



LES 



BX, DWORD PTR [BP] + 4 
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;Load ES with base address and B)( with offset of string 
; (addresses pushed onto stack by calling routine) 

CHECK: 

CMP BYTE PTR ES: CBX] [SI], 

/terminator character 
;is ASCII 

JZ DONE ;nuLl = alL zeroes if 

; d o n e , exit 

MOV AL, BYTE PTR ES: [BX] [SI] ;put next char on 

PUSH AX 

CALL SI0._0UT_CHAR jstack for output by 

;this called procedure 

INC SI ,-point index to next 

; c h a r 

JMP CHECK 
DONE: 

POP BP 

RET 4 ; after return, resets 

;SP behind former 
; parameters 

SIO OUT STRING ENDP 
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FUNCTION 



FORMAT 



186 
Clock 
Cycles 



Comments 



DATA TRANSFER 
MOV = Move: 

Register to Register/Memory 

Register/memory to register 
Immediate to register/memory 
Immediate to register 
Memory to accumulator 
Accumulator to memory 
Register/memory to segment register 
Segment register to register/memory 

PUSH = Push: 

Memory 

Register 

Segment register 
Immediate 

PUSHA« Push Alii 

POP = Pop: 

Memory 

Register 
Segment register 

i>opA«popAii : ■:■/. 

XCHG = Exchange: 

Register/memory with register 

Register with accumulator 

IN = Input from: 

Fixed port 

Variable port 

0UT = Output to: 

Fixed port 

Variable port 

XLAT = Translate byte to AL 
LEA = Load EAto register 
LDS = Load pointer to DS 
LES = Load pointer to ES 
LAHF - Load AH with flags 
SAHF = Store AH into flags 
PUSHF = Push flags 
P0PF = Pop flags 



1 10 w | mod reg r/m | 



1 1 1 w J mod reg r/m 



1 1 1 1 w | "mod 000 r/m | 



data 



dataifw^l 



1 1 1 w reg | 



data 



1 1 w | 



addr-low 



1 1 1 w | 



addr-low 



1 1 1 1 | mod reg r/m 
10 110 0) mod reg r/m 



1 1 1 1 1 1 1 1 | mod 1 1 r/m | 



10 10 reg | 



reg 1 1 | 



110 1 slTf 



It) I- 4 ¥] 



1 1 1 1 1 | mod 00 r/m 
10 11 reg~] 



reg 1 1 1 | (reg 4 01) 



1 1 1 1 w | mod reg r/m | 




|1 1 reg | 




|1 1 1 1 w [ port | 




|1 1 1 1 1 w | 




1 1 1 1 1 1 w | port | 




|1 1 1 1 1 1 w | 




|1 10 10 11 1 | 




1 1 1 1 1 | mod reg r/m | 




1 1 1 1 1 ) mod reg r/m I 




1 1 1 1 I mod reg r/m | 




|1 1 1 1 1 1 | 




|1 1 1 1 1 | 




|1 1110 0| 




|1 1 1 1 1 | 



data if w — 1 



addr-high 



addr-high 



dataifs = G 



(mod * 11) 
(mod * 11) 



2/12 

2/9 

12-13 

3-4 

9 

8 
2/9 
2/11 

16 
10 
9 
10 

36 

20 
10 
8 

I: 51 

4/17 
3 

10 
8 

9 

7 
11 

6 
18 
18 

2 

3 

9 

8 



8/16-bit 
8/16-bit 



Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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186 INSTRUCTION SET SUMMARY (Continued) 



FUNCTION 


FORMAT 








186 
Clock 
Cycles 


Comments 


ARITHMETIC 
ADD = Add: 

Reg/memory with register to either 

Immediate to register-memory 
Immediate to accumulator 

ADC = Add with carry: 

Reg/memory with register to either 

Immediate to register/memory 
Immediate to accumulator 

INC = Increment: 

Register/memory 

Register 

SUB = Subtract: 

Reg/memory and register to either 

Immediate from register/memory 
Immediate from accumulator 

SBB = Subtract with borrow: 

Reg/memory and register to either 

Immediate from register/memory 
Immediate from accumulator 

DEC = Decrement: 

Register/memory 

Register 

CMP = Compare: 

Register/memory with register 

Register with register/memory 
Immediate with register/memory 
Immediate with accumulator 
NEG- Change sign 
AAA -ASCI I adjust for add 
DAA - Decimal adjust for add 
AAS- ASCII adjust for subtract 
DAS = Decimal adjust for subtract 

MUL -= Multiply (unsigned): 

Register-Byte 

Register-Word 

Memory-Byte 

Memory-Word 

IMUL = Integer multiply (signed): 

Register-Byte 

Register-Word 

Memory-Byte 

Memory-Word 

IMUL - 1 nteger i mmed iate mu Iti ply 
(signed). 

DIV = Divide (unsigned): 

Register-Byte 

Register-Word 

Memory-Byte 

Memory-Word 










3/10 
4/16 
3/4 

3/10 
4/16 
3/4 

3/15 
3 

3/10 
4/16 
3/4 

3/10 
4/16 
3/4 

3/15 
3 

3/10 
3/10 
3/10 
3/4 

3 

8 

4 

7 

4 

26-28 
35-37 
32-34 
41-43 

25-28 
34-37 
31-34 
40-43 

22-25/29-32 

29 
38 
35 
44 


8/16-bit 
8/16-bit 

8/16-bit 
8/16-bit 

8/16-bit 


|0 d w | 


mod reg rm | 


|1 s w | 


mod 00 rm | 


data 


| data if sw- 01 | 








1 


|0 1 w | 


data | 


data if w - 1 


JO 1 d w | 


mod reg r m | 


|1 s w | 


mod 1 r. m | 


data 


| data if s w - 01 | 


|0 1 1 w | 


data | 


data if w - 1 


1 


|1 1 1 1 1 1 1 w | 


mod 00 rm | 






(01000 reg | 


|0 1 1 d w | 


mod reg r m | 


|1 s w | 


mod 1 1 rm | 


data 


] data if s w - 1 | 


|0 1 1 1 w | 


data | 


data if w- 1 


1 


|0 1 1 d w | 


mod reg r m | 


|1 s w | 


mod 1 1 rm | 


data 


| data if s w - 1 | 


|0 1 1 1 w | 


data ( 


data if w - 1 


1 


|1 1 1 1 1 1 1 w | 


mod 1 r m | 






1 10 1 reg | 


|0 1 1 1 1 w | 


mod reg r m | 


1 1 1 1 w | 


mod reg r/m | 


|1 00000s w| 


mod 1 1 1 r.m | 


data 


| data if s w - 1 | 


|0 1 1 1 1 w| 


data | 


data if w — 1 


1 


1 1 1 1 1 1 1 w | 


mod 1 1 r'm | 


(0011011 1 | 




1 1 1 1 1 | 


(0011111 1 | 


1 1 1 1 1 1 | 


|1 1 1 1 1 1 w| 


mod 1 r m | 






1 1 1 1 1 1 1 w | 


mod 1 1 r/m | 






(0 1 1 1 s 1 | 


mod reg r/m j 


data 


( dataifs = Q | 










|1 1 1 1 1 i w| 


mod 1 1 r'm | 







Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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186 INSTRUCTION SET SUMMARY (Continued) 



FUNCTION 



FORMAT 



186 
Clock 
Cycles 



Comments 



ARITHMETIC (Continued): 

IDIV = Integer divide (signed): 

Register-Byte 

Register-Word 

Memory-Byte 

Memory-Word 

AAM = ASCII adjust for multiply 

AAD = ASCII adjust for divide 
CBW == Convert byte to word 
CWD = Convert word to double word 

LOGIC 

Shift/Rotate Instructions: 

Register/Memory by 1 

Register/Memory by CL 
Register/Memory by Count 



AND = And: 

Reg/memory and register to either 

Immediate to register/memory 
Immediate to accumulator 

TEST = And function to flags, no result: 

Register/memory and register 

Immediate data and register/memory 
Immediate data and accumulator 

0R = 0r: 

Reg/memory and register to either 

Immediate to register/memory 
Immediate to accumulator 

XOR = Exclusive or: 

Reg/memory and register to either 

Immediate to register/memory 
Immediate to accumulator 
NOT = Invert register/memory 

STRING MANIPULATION: 
MOVS - Move byte/word 

CMPS = Compare byte/word 

SCAS = Scan byte/word 

LODS = Load byte/wd to AL/AX 

STOS = Stor byte/wd from AL/A 

\m = Input byte/wd from DX port 

- OUTS = Output byte'wd to DX port 



1 1 1 1 1 1 1 w | mod 1 1 1 r/m 



|1 1010100|00001010 

[1 1010101|00001010 

1 1 1 1 | 

|1 110 1) 



1 1 1 1 w I mod TTT r/m | 
1 1 1 1 1 w | mod TTT r/m | 
1 1 1 w | mod TTT rm | cciuiitl 



TTT Instruction 

ROL 



1 

1 

1 1 

1 
1 1 
1 1 1 



ROR 
RCL 
RCR 
SHL/SAL 
SHR 
SAR 



1 1 d w | mod reg r/m | 




1 1 w | mod 1 r/m | data | data if w - 1 | 




|0 1 1 w | data | dataifw-1 | 




1 1 1 w | mod reg r/m | 




1 1 1 1 1 1 1 w | mod r/m | data | data if w - 1 | 




|1 1 1 w | data | data if w = 1 | 




1 1 d w | mod reg r/m | 




|1 00 00 w| mod 001 r/m | data | data if w - 1 | 




|0 1 1 w | data | data if w = 1 | 




1 1 1 d w [ mod reg r/m | 




|1 00 00 w| modi 10 r/m | data | data if w = 1 | 




|0 1 1 1 w| data | data if w= 1 | 




1 1 1 1 1 1 1 w | mod 1 r/m | 




|1 1 1 w| 




|1 1 1 1 w | 




|1 1 1 1 1 w[ 




|1 1 1 1 w | 




1 1 10 10 1 w | 



44-52 

53-61 
50-58 
59-67 

19 

15 

2 

4 



2/15 
5 + n/17 + n 

:5+-n/17+rv 



3/10 
4/16 

3/4 

3/10 
4/10 
3/4 

3/10 
4/16 
3/4 

3/10 

4/16 

3/4 

3 



14 
22 
15 
12 
10 

14 
14 



8/16-bit 



8/16-bit 



8/16-bit 



8/16-bit 



Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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186 INSTRUCTION SET SUMMARY (Continued) 



FUNCTION FORMAT 


186 
Clock 
Cycles 


Comments 


STRING MANIPULATION (Continued): 

Repeated by count in CX 


8+8n 
5+22n 
5 + 15n 
6+11n 

6+9n 

■'■'. 8 : *t**!J8n : V 

14 
13/19 

23 

38 

13 

13 

11/17 

13 
26 

16 
18 
22 

25 




MOVS Move string |1 1 1 1 1 


1 1 1 w| 


CMPS Compare string |1 1110 1 z 


1 1 1 1 w| 


SCAS - Scan string 1 1 1110 1 z 


1 1 1 1 1 w | 


LODS Load string |1 1110010 


1 1 1 1 w| 


STOS Store string 1 1 1110 1 


1 1 1 1 w | 


INS- Input string J1 1 1 1 1 


!0 110 1 1 w| 


OUTS -Output string jl 1 1 10 6 1 

CONTROL TRANSFER 
CALL = Call: 


1 1 1 11 w) 


Direct within segment |1 110 10 


disp-low | disp-high | 


Register memory 1 1 111111 1 


mod 1 r m | 


indirect within segment 


Direct intersegment |1 1 10 1 


segment offset | 




segment selector | 




Indirect intersegment |1 111111 1 


mod 01 1 r m | (mod < 11) 


JMP = Unconditional jump: 


Short/long 1 1 110 10 1 1 


[ disp-low | 


Direct within segment |1 110 10 1 


disp-low | disp-high | 




Register'memory indirect within segment) 1 111111 1 


modi 00 rm | 


Direct intersegment 1 1 110 10 1 


segment offset | 






segment selector | 




Indirect interseqment M 111111 1 


mod 101 rm | (mod • 11) 


RET = Return from CALL: 




Within segment |1 10 1 1 


Within seg adding immed to SP |1 10 1 


data-low | data-high | 


Intersegment |1 10 10 1 1 | 


Intersegment adding immediate to SP |1 10 10 1 


data-low j data-high | 





Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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186 INSTRUCTION SET SUMMARY (Continued) 



FUNCTION 


FORMAT 


I 


186 
Clock 
Cycles 


Comments 


CONTROL TRANSFER (Continued): 

JE/JZ = Jump on equal zero 
JL/JNGE = Jump on less/not greateror equal 
JLE/JNG = Jump on less or equal/not greater 
JB/JNAE - Jump on belownot above or equal 
JBE/JNA = Jump on below or equal/not above 
JP/JPE = Jump on parity ; paiity even 
JO ^ Jump on overflow 
JS = Jump on sign 

JNE/JNZ = Jump on not equal/not zero 
JNL/JGE = Jump on not less/greater or equal 
JNLE/JG = Jump on not less or equal/greater 
JNB/JAE = Jump on not belowabove or equal 
JNBE/JA = Jump on not below or equal-above 
JNP/JPO = Jump on not par/par odd 
JNO = Jump on not overflow 
JNS = Jump on not sign 
LOOP = Loop CX times 
LOOPZ/LOOPE - Loop while zero/equal 
LOOPNZ/LOOPNE = Loop while not zero-equal 
JCXZ = Jump on CX zero 

jENTER^ Enter Procedure 
L = 
L*1 

LEAVE ~ Leave Procedure 

INT= Interrupt: 

Type specified 

Type 3 

INTO = Interrupt on overflow 

IRET = Interrupt return 

BOUND -* Detect value out of range 






4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 
4/13 

4/13 
5/15 
6/16 
6/16 

16 

5 

15 

25 

22 + 16(n-1) 

8 

47 
45 
48/4 

28 

33-35 


13 if JMP 

taken 
4 if JMP 
not taken 

JMP taken/ 
JMP not taken 

if INT. taken/ 

if INT. not 

taken 


[01110100 


disp | 


|0 1 1 1 1 1 


disp | 


|0 1 1 1 1 1 1 


disp | 


1 1 1 1 1 


disp | 


1 1 1 1 1 1 


disp | 


|0 1 1 1 1 1 


disp | 


•| 1 1 1 


disp | 


1 11 1 10 


disp | 


|0 1 1 1 1 1 


disp | 


[0 111110 1 


disp | 


|0 1 1 1 1 1 1 1 


disp | 


[0111001 1 


disp | 


1 1 1 1 1 1 1 


disp | 


1 11 1 10 1 1 


disp | 


[0 111000 1 


disp | 


[0 1111001 


disp | 


|1 110 1 


disp | 


|1 110 1 


disp | 


|1 110 


disp | 


|1 110 1 1 


disp | 






[110 1 Q 


.; data-low | data-high | L : | 


|i' : T'Q;f'?I'0 l '' l l''' : 




1 1 10 110 1 


type | 


|1 10 110 




|1 10 111 


| 1 10 111 1 




|0 110 1 


modreg r/m | 



Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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186 INSTRUCTION SET SUMMARY (Continued) 



FUNCTION 


FORMAT 


186 
Clock 
Cycles 


Comments 


PROCESSOR CONTROL 

CLC = Clear carry 

CMC -Complement carry 

STC = Set carry 

CLD = Clear direction 

STD = Set direction 

CLI = Clear interrupt 

STI- Set interrupt 

HLT = Halt 

WAIT = Wait 

LOCK = Bus lock prefix 

ESC = Processor Extension Escape 




2 
2 
2 
2 
2 
2 
2 
2 
6 
2 
6 


if test = 


|1 1 1 1 1 | 


|1 1 1 1 1 1 | 


|1 1 1 1 1 1 | 


|1 1 1 1 1 1 | 


|1 1 1 1 1 1 1 | 


j 1 1 1 1 1 1 | 


1 1 11110 1 1 | 


|1 1 1 1 1 | 


1 1 1 1 1 1 | 


|1 1 1 1 | 




1 1 1 1 T T T | mod LLL r/m | 


(TTT LLL are opcode to processor extension) 



Shaded areas indicate instructions not available in iAPX 86, 88 microsystems. 
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FOOTNOTES 

The effective Address (EA) of the memory operand is 
computed according to the mod and r/m fields: 

if mod = 1 1 then r/m is treated as a REG field 

if mod = OOthenDISP = 0*, disp-lowanddisp-high 

are absent 

if mod = 01 thenDISP = disp-low sign-extended to 

1 6-bits, disp-high is absent 

if mod = 10 thenDISP = disp-high: disp-low 



if r/m = 000 then EA 
if r/m = 001 then EA 
if r/m = OlOthenEA 
if r/m = 01 1 then EA 
if r/m = 100 then EA 
if r/m = 101 then E A 
if r/m = 110 then EA 
if r/m = 111 then EA 



(BX) + (SI) + DISP 
(BX) + (Dl) + DISP 
(BP) + (SI) + DISP 
(BP) + (Dl) + DISP 
(SI) + DISP 
(Dl) + DISP 
(BP) + DISP* 
(BX) + DISP 



REG is assigned according to the following table: 
16-Bit(w = 1) 8-Bit(w = 0) 



000 


AX 


000 


AL 


001 


ex 


001 


CL 


010 


DX 


010 


DL 


011 


BX 


011 


BL 


100 


SP 


100 


AH 


101 


BP 


101 


CH 


110 


SI 


110 


DH 


111 


Dl 


111 


BH 



The physical addresses of all operands addressed by 
the BP register are computed using the SS segment 
register. The physical addresses of the destination op- 
erands of the string primitive operations (those ad- 
dressed by the Dl register) are computed using the ES 
segment, which may not be overridden. 



DISP follows 2nd byte of instruction (before data if 
required) 

'except if mod = 00 and r/m = HOthenEA = disp-high: disp-low. 



SEGMENT OVERRIDE PREFIX 

1 reg 1 1 o ] 



reg is assigned according to the following: 



reg 


Segment 
Register 


00 


ES 


01 


CS 


10 


SS 


11 


DS 
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17-bit number, 3-2 

186 Clocks, H-l-H-7 

186 Instruction Set Summary, H-l-H-7 

8086/8087/8088 Development tools, vi, 1-1, 1-2 

8086/8088 flags 

{see Flags) 
8087 Control word, 6-110 
8087 Data types, 3-1, 3-2, 6-112 
8087 Emulators, 6-116 
8087 environment, 6-109 
8087 Exception pointers, 6-112 
8087 Rounding masks, 6-114 
8087 Status word, 6-109 
8087 Tag word, 6-111 

AAA, ASCII Adjust for Addition, 6-21 
AAD, ASCII Adjust for Division, 6-22 
AAM, ASCII Adjust for Multiplication, 6-23 
AAS, ASCII Adjust for Subtraction, 6-24 
ABS, external type, 5-2 

ADC, Add with Carry, 6-25 

ADD, 6-26 

addition operator, +,4-12 
addressability of data/code, 1-9, 2-5, 4-14-4-15 
address expression, 3-4, 2-6, 2-7, 4-7-4-8 
addressing modes, 4-3, 6-1 

based address, 4-4 

based indirect address, 4-4, 4-18 

direct address, 4-3 

indexed address, 4-4 

register indirect address, 4-3, 4-18 
align-type, segment attribute, 2-2 
AND, Logical And, 4-13 
AND, Logical expression operator, 6-27 
anonymous references, 4-5, 6-5 
arithmetic operators, 4-10-4-12 
Assembly language, 1-1 
assembly language statements, 1-5 
ASSUME directive, 1-9, 2-5-2-8, 4-5, 4-14, 4-18 
AT, Segment combine-type, 2-3, 4-9 
attribute operators 

attribute overriding operators, 4-4-4-16 

attribute value operators, 4-17-4-21 

base relocatability, 4-9, 4-18 
BOUND, check array, 6-28 
BYTE 

external variable type, 5-2 . 

segment align-type, 2-2 

variable type operand, 3-18, 4-16, 4-17 

CALL, 6-29 

CBW, Convert Byte to word, 6-31 
Character Set, 1-3 
CI, console input, 7-19 
classname, segment attribute, 2-3 
CLC, Clear Carry Flag, 6-32 
CLD, Clear Direction Flag, 6-33 
CLI, Clear Interrupt Flag, 6-34 



CMC, Complement Carry Flag, 6-35 

CMP, Compare, 6-36 

CMPS, Compare String, 6-99 

CMPSB, Compare Byte String, 6-99 

CMPSW, Compare Word String, 6-99 

CO, console output, 7-19 

CODEMACRO directive, A-l-A-17 

codemacro matching, A- 14 

codemacro modifiers, A-4 

codemacro range specifiers, A-4 

codemacros, A-l-A-17 

codemacro specifiers, A-3 

Codemacros, list of, A-18-A-33 

combine-type, segment attribute, 2-2 

combining logical segments, 2-2, 2-8 

COMMON, segment combine-type, 2-2 

conditional jump instructions, 4-16, 6-12-6-13, 6-52 

constants, 3-2, 3-5, 4-24 

ASCII, 3-3, 3-7, 3-8 

binary, 3-3 

decimal, 3-3 

decimal real, 3-2, 3-3 

hexadecimal, 3-3 

hexadecimal real, 3-2, 3-3 

octal, 3-3 
continuation lines, 1-5 
CPU hardware, overview, 1-5 
Crowley, Aleister, 3-4 
CWD, Convert Word to Double Word, 6-37 

DA A, Decimal Adjust for Addition, 6-38 

DAS, Decimal Adjust for Subtraction, 6-39 

data types, 3-1, 3-2 

DB, Define byte directive,3-3, A-7 

DD, Define directive, 3-3, A-7 

debug information, control of, 3-19 

DEC, Decrement, 6-40 

Delimiters, 1-4, 7-20 

DIV, divide, 6-41 

division operator, /, 4-1 1 

Dot operator, codemacro operator, A- 12 

DQ, Define word directive, 3-4 

DT, Define tbyte directive, 3-4 

DUP, repeated data initialization, 3-7-3-8 

DW, Define word directive, 3-3, A-7 

DWORD 
external variable type, 5-2 
variable type operand, 3-18, 4-16, 4-17 

END directive, 5-3-5-5 

ENTER, high level entry, 6-43 

EQ, Relational expression operator, 4-12 

EQU directive, 4-17, 4-24 

ESC, Escape, 6-42 

EVEN directive, 3-19 

expression operands, 4-2, 4-6-4-8 

address expressions, 4-7-4-8 

numbers, 4-2, 4-6, 4-25 
EXTRN directive, 4-9, 4-10, 5-1-5-3 
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F2XMI, Calculate, 6-123 
FABS, absolute value, 6-124 
FADD, add real, 6-125 
FADDP, Add real and pop, 6-126 
FAR 

external label type, 5-2 

label type operand, 3-18, 4-16, 4-17 

PROC type, 3-17 
FBLD, Load packed decimal, 6-127 
FBSTP, Store packed decimal, 6-128 
FCHS, change sign, 6-129 
FCLEX, clear exceptions, 6-130 
FCQM, Compare real, 6-131 
FCOMP, Compare real and pop, 6-133 
FCOMPP, Compare real and pop twice, 6-135 
FDECSTP, Decrement stack pointer, 6-137 
FDISI, Disable interrupts, 6-138 
FDIV, Divide real, 6-139 
FDIVP, Divide real and pop, 6-140 
FDIVR, Reversed divide real, 6-141 
FDIVRP, Reversed divide real and pop, 6-142 
FENI, Enable interrupts, 6-143 
FFREE, Free stack element, 6-144 
FIADD, Add integer, 6-145 
FICOM, Compare integer, 6-146 
FICOMP, Compare integer and pop, 6-148 
FIDIV, Divide integer, 6-150 
FIDIVR, Reversed divide integer, 6-151 
FILD, Load integer, 6-152 
FIMUL, Multiply integer, 6-153 
FINCSTP, Increment stack pointer, 6-154 
FINIT, Initialize processor, 6-155 
FIST, Store integer, 6-156 
FISTP, Store integer and pop, 6-157 
FISUB, Subtract integer, 6-158 
FISUBR, Reversed subtract integer, 6-159 
Flags, 6-4, 6-8, 6-14, 6-16, B-l-B-3 
FLD, Load real, 6-160 
FLDCW, Load control word, 6-161 
FLDENV, Load 8087 environment, 6-162 
FLDL2E, Load log 2 e, 6-165 
FLDL2T, Load log 2 1 0, 6- 1 66 
FLDLG2, Load log 10 2, 6-163 
FLDLN2, Load log e 2, 6-164 
FLDPI, Load II, 6-167 
FLDZ, Load +0.0, 6-168 
FLD 1, Load +1.0,6-169 
Floating Point Stack, 4-2, 6-108 
FMUL, Multiply real, 6-170 
FMULP, Multiply read and pop, 6-171 
FNCLEX, Clear exceptions with no WAIT, 6-130 
FNDISI, Disable interrupts with no WAIT, 6-138 
FNENI, Enable interrupts with no WAIT, 6-143 
FNINIT, Initialize processor with no WAIT, 6-155 
FNOP, No operation, 6-172 
FNSAVE, Save 8087 state with no WAIT, 6-178 
FNSTCW, Store control word with no WAIT, 6-183 
FNSTENV, Store 8087 environment with no WAIT, 6-184 
FNSTSW, Store 8087 status word with no WAIT, 6-187 
forward references, 1-3, 2-7 
FPATAN, Partial arctangent, 6-173 
FPREM, Partial remainder, 6-174 
FPTAN, Partial tangent, 6-175 
FRNDINT, Round to integer, 6-176 
FRSTOR, Restore 8087 state, 6-177 



FSAVE, Save 8087 state, 6-178 

FSCALE, Scale, 6-180 

FSQRT, Square root, 6-181 

FST, Store real, 6-182 

FSTCW, Store control word, 6-183 

FSTENV, Store 8087 environment, 6-184 

FSTP, Store real and pop, 6-186 

FSTSW, Store 8087 status word, 6-187 

FSUB, Subtract real, 6-188 

FSUBP, Subtract real and pop, 6-189 

FSUBR, Reversed subtract real, 6-190 

FSUBRP, Reversed subtract real and pop, 6-191 

FTST, Test, 6-192 

FWAIT, CPU WAIT alternate form, 6-193 

FXAM, Examine, 6-194 

FXCH, Exchange, 6-195 

FXTRACT, Extract exponent and significand, 6-196 

FYL2X, Calculate Y log 2 x, 6-198 

FYL2P1, Calculate Y log 2 (X + 1), 6-199 

GE, Relational expression operator, 4-12 

GROUP directive, 2-8, 4-9, 4-18 

GT, Relational expression operator, 4-12 

HIGH operator, 4-10 
HLT, Halt, 6-44 

Identifiers, 1-4 

indeterminate initialization of data, 3-6 

initializing a segment register, 2-6, 2-8, 4-18, 5-3-5-5, F-2 

IDI-V, Integer Divide, 6-45 

IMUL, Integer Multiply, 6-46 

IN, Input byte or word, 6-48 

INC, Increment, 6-49 

INPAGE, segment align-type, 2-2 

INS, input IO address to memory, 6-100 

instruction operands, 4-1, 4-2 

immediate, 4-2 

register, 4-2, 6-3 

memory, 4-3, 6-1-6-3 
instruction statements, 4-1,6-1 
INT, Interrupt, 6-50 
integer constants, 3-2 
INTO, Interrupt on Overflow, 6-50 
Interrupt Procedures, G-14 
interrupts, 6-13-6-14 
IRET, Interrupt Return, 6-51 

JA, Jump or Above, 6-52 
JAE, Jump or Above or Equal, 6-52 
JB, Jump or Below, 6-52 
JBE, Jump or Below or Equal, 6-52 
JC, Jump or Carry Flag, 6-52 
Jcond, conditional jump instructions 
(see conditional jump instructions) 
JCXZ, Jump or CX Zero, 6-52 
JE, Jump or Equal, 6-52 
JG, Jump or Greater, 6-52 
JGE, Jump or Greater or Equal, 6-52 
JL, Jump or Less, 6-52 
JLE, Jump or Less or Equal, 6-52 
JMP, Jump, 6-54-6-55 
JNA, Jump or Not Above, 6-52 
JNAE, Jump or Not Above or Equal, 6-52 
JNB, Jump or Not Below, 6-52 
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JNC, Jump on No Carry Flag, 6-52 

JNBE, Jump or Not Below or Equal, 6-52 

JNE, Jump or Not Equal, 6-52 

JNG, Jump or Not Greater, 6-52 

JNGE, Jump or Not Greater or Equal, 6-52 

JNL, Jump or Not Less, 6-52 

JNLE, Jump or Not Less or Equal, 6-52 

JNO Jump or Not Overflow Flag, 6-52 

JNP, Jump or Not Parity Flag, 6-52 

JNS, Jump or Not Sign Flag, 6-52 

JNZ, Jump or Not Zero Flag, 6-52 

JO, Jump or Overflow Flag, 6-52 

JP, Jump or Parity Flag, 6-52 

JPE, Jump or Parity Even, 6-52 

JPO, Jump or Parity Odd, 6-52 

JS, Jump or Sign, 6-52 

JZ, Jump or Zero Flag, 6-52 

label 

attributes of, 3-1-3-2 

defining, 3-2, 3-15-3-18, 4-1, 4-24 

operand Of instruction or expression, 4-3 
LABEL directive, 3-17-3-18, 4-17 
LAHF, Load AH with Flags, 6-56 
LDS, Load Pointer into PS, 6-57 
LE, Relational expression operator, 4-12 
LEA, Load Effective Address, 6-58 
LEAVE, high level exit, 6-59 
LENGTH operator, 4-20 
LES, Load pointer into ES, 6-57 
Location counter ($), 3-18 
LOCK, Lock Bus, 6-60 
LODS, Load String, 6-100 
LODSB, Load byte string, 6-100 
LODSW, Load word string, 6-100 
logical address, 1-8 
logical segments 

(see segments) 
logical operators, 4-13 
LOOP, 6-61 

LOOPE, Loop while Equal, 6-61 
LOOPNE, Loop while Not Equal, 6-61 
LOOPNZ, Loop while Not Zero, 6-61 
LOOPZ, Loop while Zero, 6-61 
LOW operator, 4-10 
LT, Relational expression operator, 4-12 

Macro Processor Language (MPL), 1-5 
arguments to macros, 7-6 
■arithmetic expressions, 7-11 
bracket function, 7-10 
call-literally character ( ), 7-6 
. CI, console input, 7-19 
CO, console output, 7-19 
comments as macros, 7-8 
conditional assembly, 7-14 
console I/O 

(see CI, CO, IN, OUT under Macro Processing 

Language) 
DEFINE function, 7-2 
delimiters 

comma, 7-6 

identifier, 7-20 

literal, 7-21 

other, 7-20 



EQ, relational operator, 7-11 

EQS, string compare function, 7-12 

Escape function, 7-9 

EVAL function, 7-12 

EXIT function, 7-16 

GT, relational operator, 7-1 1 

GTS, string compare function, 7-12 

IF ... THEN ... [ELSE ... ] Fl function, 7-14 

IN function, 7-19 

LE, relational operator, 7-11 

LEN function, 7-17 

LES, string compare function, 7-12 

Local Symbols, 7-7 

Logical expressions, 7-11,7-12 

MATCH function, 7-18 

Metacharacter (%), 7-1 1 

NE, relational operator, 7-1 1 

NES, string compare function, 7-12 

OUT function, 7-19 

parameters, 7-6 

REPEAT function, 7-16 

SET, Built-in macro function, 7-11 

String compares, 7-12 

SUBSTR function, 7-17 

values, range of, 7-11 

WHILE function, 7-15 
MASK operator, 4-22 
Memory Segmentation model, 1-8 
MEMORY, segment combine-type, 2-2 
mnemonic, 1-1,1-3, 4-1, 4-24, 6-1, 6-6, 6-20, 6-122 
MOD, expression operator, 4-1 1 
modrm byte, 6-2, 6-16 
MODRM, Codemacro directive, A-6 
module, source, 1-9, 5-1, 5-5 
MOV, Move data, 6-62 
MOVS, Move string, 6-100 
MOVSB, Move byte string, 6-100 
MOVSW, Move word string, 6-100 
MUL, Multiply, 6-64 
multiplication operator, *, 4-11 

NAME directive, 5-5 

NE, Relational expression operator, 4-12 

NEAR 

external label type, 5-2 

label type operand, 3-18, 4-16, 4-17 

PROCtype, 3-17 
NEG, Negate, 6-65 
NOP, No operation, 6-66 
NOSEGFIX, Codemacro directive, A-5 
NOT, Logical expression operator, 4-13 
NOT, Logical Not, 6-67 
NOTHING, Assume operand, 2-5, 2-7 
numbers, 4-6, 4-10, 4-24 

OFFSET operator, 2-9, 4-15, 4-18 

offset relocatability, 4-9, 4-18 

offset, variable/label attribute, 1-8, 3-1, 3-4, 3-6, 3-15, 

4-8, 4-9 
operands, expression 

(see expression operands) 
operands, instruction 

(see instruction operands) 
operator precedence, 4-23, 7-1 1 
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operators, expression 

arithmetic, 4-10-4-12 

attribute, 4-14-4-21 

logical, 4-13 

record-specific, 4-21-4-23 

relational, 4-12-4-13 
OR, Logical expression operator, 4-13 
OR, Logical Or, 6-68 
ORG directive, 3-18 
OUT, Output byte or word, 6-69 
OUTS, 6-100 

PAGE, segment align-type, 2-2, 4-9 
paragraph number 

segment base pointer, 1-8, 2-7 

variable/label attribute, 3-1,4-18 
parameter passing, G-4-G-12 
PARA, Segment align-type, 2-2, 4-9 
physical address, 1-8 
physical segments, 1-8, 1-9 

(see segments) 
pointer to variable/labe, 3-6, 6-7 
POP, Pop from stack, 6-70 
POPA, Pop All Registers, 6-71 
POPF, Pop Flags, 6-72 
Prefix, instructions, 4-1 
PREFX, Codemacro directive, A-2 
PROC/ENDP directives, 3-2, 3- 1 5-3- 1 7 
PROCLEN, Codemacro directive, A- 14 
program linkage, 5-1-5-5 
program module 

(see module, source) 
PTR operator, 4-15-4-16 
PUBLIC directive, 5-1 
PUBLIC, segment combine-type, 2-2, 4-9 
PURGE directive, 3-19 
PUSH, Push onto stack, 6-73 
PUSH A, Push All Registers, 6-75 
PUSHF, Push Flags, 6-76 

QWORD 

external variable type, 5-2 
variable type operand, 4-16, 4-17 

RCL, Rotate through Carry Left, 6-77- 

RCR, Rotate through Carry Right, 6-79 

real constants, 3-2-3-3 

RECORD directive, 3-8 

record field-name, usage as shift count, 4-22 

Records 

allocation and initialization, 3-8, 3-10, A-7 

definition, 3-8-3-9 

introduction, 3-8 

record-specific operators, 4-21-4-23 
Record-specific operators, 4-21-4-23 
register expression, 4-3-4-6, 4-7-4-8, 4-25 
Registers, 4-24 

base or pointer registers, 1-6, 4-3, 4-4, 4-5, 4-7 

general registers, 1-6 

implicit use of, 1-7, 4-4-4-6, 4-15, 6-5 

segment registers, 1-7, 4-4-4-6 
relational operators, 4-12-4-13 
RELB, Codemacro directive, A-8 
relocatable expressions, 4-9, 4-12 
relocatability, 4-9 



RELW, Codemacro directive, A-8 

REP, Repeat, 6-81 

REPE,6-81 

repeated initialization of data, 3-7-3-8 

REPNE, 6-81 

REPNZ, 6-81 

REPZ, 6-81 

reserved words, 6-1 

RET, Return, 6-82 

RFIX, Codemacro directive, A- 10 

RFIXM, Codemacro directive, A- 10 

RNFIX, Codemacro directive, A-l 1 

RNFIXM, Codemacro directive, A- 12 

ROL, Rotate Left, 6-83 

ROR, Rotate Right, 6-85 

RWFIX, Codemacro directive, A- 13 



SAHF, Store AH into Flags, 6-87 

SAL, Shift Arithmetic left, 6-88 

SAR, Shift Arithmetic Right, 6-90 

SBB, Subtract with Borrow, 6-92 

SCAS, Scan string, 6-100 

SCASB, Scan byte string, 6-100 

SCASW, Scan word string, 6-100 

scope of identifiers, 1-4, 3-15 

SEGFIX, Codemacro directive, A-4 

segment attribute of variables/labels, 3-1, 3-4, 3-6, 4-8, 4-9 

SEGMENT/ENDS directive, 1-9, 2-1-2-5, 4-9 

Segment override, 4- 1 4-4- 1 5 

Segment Override Prefix, 2-6, 4-14-4-15, 6-2 

segment register, default usage, 4-4-4-6 

segments 

logical segments, 1-8, 2-1, 4-9 

physical segments, 1-8, 2-1, 4-9 
SEG operator, 2-7, 2-9, 4-18 
Separators, 1-4 

shift count, record name, 4-22 
SHL, expression operator, 4-1 1 
SHL, Shift Left, 6-88 
SHORT operator, 4-16 
SHR, expression operator, 4-1 1 
SHR, Shift Right, 6-94 
SIZE operator, 4-21 
ST, 8087 registers, 4-2 
STACK, segment combine-type, 2-2, 4-9 
STC, Set Carry Flag, 6-96 
STD, Set Direction Flag, 6-97 
STI, Set Interrupt Flag, 6-98 
storage of 16-bit data in memory 
STOS, Store string, 6-100 
STOSB, Store byte string, 6-100 
STOSW, Store word string, 6-100 
String instructions, 4-5, 6-4-6-6, 6-10-6-12, 6-99 
strings 

(see constants, ASCII) 
structure fields, accessing of, 4-8 
Structures 

allocation and initialization, 3-12-3-14, 4-8 

definition, 3-11-3-12 

introduction, 3-10 
STRUC/ENDS directive, 3-11 
SUB, subtract, 6-102 
subtraction operator, —,4-12 
syntax notation, 1-10 
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TBYTE 

external variable type, 5-2 

variable type operand, 3-18, 4-16, 4-17 
TEST, 6-103 
THIS operator, 4-17 
Tokens, 1-4 

TYPE operator, 4-19-4-20 
typing of operands, 1-3, 4-15, 4-17 
type of variable or label, 3-1-3-2, 3-4 

variable 
attributes of, 3-1, 4-9 
defining, 3-3-3-5, 4-24 
initializing, 3-4, 3-5-3-8 
operand of instruction or expression, 4-3 

WAIT, 6-104 
WIDTH operator, 4-23 



WORD 

external variable type, 5-2 

Segment align-type, 2-2 

Variable type operand, 3-18, 4-16, 4-17 

XCHG, Exchange, 6-105 
XL AT, Translate, 6-106 
XLATB, Translate, 6-106 
XOR, Logical Exclusive Or, 4-13 
XOR, Logical expression operator, 6-107 

+ , addition operator, 4-12 

/, division operator, 4-1 1 

?, indeterminate initialization, 3-6, 3-7, 4-17 

$, location counter symbol, 3-18, 4-17 

*, multiplication operator, 4-1 1 

??SEG, the default segment, 2-5 

— , subtraction operator, 4-12 
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